List request statuses | Docusign

{
  "_links": {
    "self": {
      "href": "https://api.docusign.com/v1/accounts/9f8e7d6c-1234-4a5b-8c9d-0e1f2a3b4c5d/request-statuses"
    }
  },
  "response_metadata": {
    "request_id": "3f7c9e4b-851c-4f9b-89e7-123456789abc",
    "response_timestamp": "2026-08-26T14:30:00Z",
    "page_limit": 25
  },
  "statuses": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Draft",
      "state": "Open",
      "metadata": {
        "created_at": "2024-01-10T09:00:00Z",
        "created_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333",
        "modified_at": "2024-01-10T09:00:00Z",
        "modified_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333"
      }
    },
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "name": "In Review",
      "state": "Open",
      "metadata": {
        "created_at": "2024-01-10T09:00:00Z",
        "created_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333",
        "modified_at": "2024-01-10T09:00:00Z",
        "modified_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333"
      }
    },
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "name": "Closed",
      "state": "Closed",
      "metadata": {
        "created_at": "2024-01-10T09:00:00Z",
        "created_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333",
        "modified_at": "2024-01-10T09:00:00Z",
        "modified_by": "aaaa1111-bbbb-4ccc-8ddd-eeee22223333"
      }
    }
  ]
}

Returns the list of request statuses configured for the account.

Authentication

AuthorizationBearer

Docusign OAuth 2.0 access token

Path parameters

accountIdstringRequiredformat: "uuid"

The ID of the account that owns the request statuses.

Response

The list of request statuses for the account.

_linksobjectOptional

Hypermedia controls (HATEOAS) for navigating between pages in a paginated collection of results. Links for the current page, next page, and previous page.

response_metadataobjectOptional

Control information and metadata for the response.

statuseslist of objectsOptional

The request statuses configured for the account.

Errors

400

Bad Request Error

401

Unauthorized Error