List Signature Requests

get

https://api-sandbox.yousign.app/v3/signature_requests

Returns the list of all Signatures Requests in your organization. You can limit the number of items returned by using filters and pagination. Consult our guide for more details and examples.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

after

string

length ≥ 1

After cursor (pagination)

limit

integer

1 to 100

Defaults to 100

The limit of items count to retrieve.

status

object

Filter by status. Allowed operators: eq, in. Example: status[in]=draft,done

created_at

object

Filter by created_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: created_at[between]=2025-03-02,2025-03-04

activated_at

object

Filter by activated_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: activated_at[after]=2025-03-01

completed_at

object

Filter by completed_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: completed_at[between]=2025-03-01,2025-03-31

approved_at

object

Filter by approved_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: approved_at[after]=2025-03-01

rejected_at

object

Filter by rejected_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: rejected_at[before]=2025-04-01

declined_at

object

Filter by declined_at. Allowed operators: eq, between, before, after. Format: the date format required is yyyy-mm-dd Example: declined_at[after]=2025-01-01

workspace_id

object

Filter by workspace_id. Allowed operators: eq. Example: workspace_id[eq]=9b6ed2f3-244f-487a-baa1-bbe4f51c8748

external_id

object

Filter by external_id. Allowed operators: eq. Example: external_id[eq]=an-external-id

source

object

Filter by source. Allowed operators: eq, in. Default value: source[eq]=public_api. If not specified, only Signature Requests created via the Public API are returned. Example: source[in]=public_api,app

string

Search on name

label.name

object

Filter by Label's name. Allowed operators: eq, in. Example: label.name[in]=To Sign,Miscellaneous

Responses

200OK

400Bad request

401Access unauthorized

403Access forbidden

405This method is not allowed

429Too Many Requests, please try again later.

500Internal Server Error