PowerForms: listSenders

Request

HTTP request

GET /v2/accounts/{accountId}/powerforms/senders

Parameters

Parameter Name	Value	Description
Path Parameters
accountId	string	The external account number (int) or account ID Guid.
Optional Query Parameters
start_position	string	The position within the total result set from which to start returning values. The value thumbnail may be used to return the page image.

Responses

Code	Description	Reference
200	Successful response.	powerFormSendersResponse
400	Error encountered.	errorDetails

Code

Description

Reference

200

Successful response.

powerFormSendersResponse

400

Error encountered.

errorDetails

SDK Method

PowerForms::listPowerFormSenders

Definitions

errorDetails

This object describes errors that occur. It is only valid for responses, and ignored in requests.

errorCode

string

An error code associated with the error.

message

string

A short error message.

powerFormSendersResponse


`endPosition`	string	The last position in the result set.
`nextUri`	string	The URI for the next chunk of records based on the search request. It is `null` if this is the last set of results for the search.
`powerFormSenders`	[userInfo]
`previousUri`	string	The URI for the prior chunk of records based on the search request. It is `null` if this is the first set of results for the search.
`resultSetSize`	string	The number of results returned in this response.
`startPosition`	string	Starting position of the current result set.
`totalSetSize`	string	The total number of items in the search's result set. It will always be greater than or equal to the value of the `resultSetSize` field.

userInfo


`activationAccessCode`	string
`email`	string
`errorDetails`	errorDetails
`loginStatus`	string
`sendActivationEmail`	string
`uri`	string
`userId`	string	The user ID of the user being accessed. Generally this is the user ID of the authenticated user, but if the authenticated user is an Admin on the account, this may be another user the Admin user is accessing. Note: For GET /v2/accounts/{accountId}/envelopes `user_id` query parameter is not implemented and should not be used.
`userName`	string
`userStatus`	string	Status of the user's account. One of: ActivationRequired ActivationSent Active Closed Disabled
`userType`	string

Examples

Generic JSON Response

Response

{
  "powerFormSenders": [
    {
      "userName": "sample string 1",
      "userId": "sample string 2",
      "email": "sample string 3",
      "userType": "sample string 4",
      "userStatus": "sample string 5",
      "uri": "sample string 6",
      "loginStatus": "sample string 7",
      "sendActivationEmail": "sample string 8",
      "activationAccessCode": "sample string 9",
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      }
    }
  ],
  "previousUri": "sample string 1",
  "nextUri": "sample string 2",
  "startPosition": "sample string 3",
  "endPosition": "sample string 4",
  "resultSetSize": "sample string 5",
  "totalSetSize": "sample string 6"
}

Generic XML Response

Response

<powerFormSendersResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <endPosition>sample string 4</endPosition>
  <nextUri>sample string 2</nextUri>
  <powerFormSenders>
    <userInfo>
      <activationAccessCode>sample string 9</activationAccessCode>
      <email>sample string 3</email>
      <errorDetails>
        <errorCode>sample string 1</errorCode>
        <message>sample string 2</message>
      </errorDetails>
      <loginStatus>sample string 7</loginStatus>
      <sendActivationEmail>sample string 8</sendActivationEmail>
      <uri>sample string 6</uri>
      <userId>sample string 2</userId>
      <userName>sample string 1</userName>
      <userStatus>sample string 5</userStatus>
      <userType>sample string 4</userType>
    </userInfo>
  </powerFormSenders>
  <previousUri>sample string 1</previousUri>
  <resultSetSize>sample string 5</resultSetSize>
  <startPosition>sample string 3</startPosition>
  <totalSetSize>sample string 6</totalSetSize>
</powerFormSendersResponse>