Skip to main content
GET
/
signing-requests
/
{id}
/
users
Get signing request users
curl --request GET \
  --url https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/users \
  --header 'Authorization: <api-key>'
{
  "results": [
    {
      "id": "user123-e89b-12d3-a456-426614174000",
      "name": "Alice Johnson",
      "email": "alice@example.com",
      "first_name": "Alice",
      "last_name": "Johnson",
      "designation": "Signer",
      "order": 1,
      "finished_on": "2024-03-15T14:30:00Z",
      "declined_on": null,
      "decline_reason": null,
      "phone_number": "+1-555-0101",
      "street_address": null,
      "city": null,
      "state_province": null,
      "postal_code": null,
      "country": null,
      "title": "CEO",
      "company": "Acme Corp",
      "custom_fields": null,
      "required_fields": [
        "email",
        "first_name"
      ],
      "missing_fields": [],
      "required_read_only_fields": [],
      "ready_to_send": true
    },
    {
      "id": "user456-e89b-12d3-a456-426614174000",
      "name": "Bob Williams",
      "email": "bob@example.com",
      "first_name": "Bob",
      "last_name": "Williams",
      "designation": "Signer",
      "order": 2,
      "finished_on": null,
      "declined_on": null,
      "decline_reason": null,
      "phone_number": null,
      "street_address": null,
      "city": null,
      "state_province": null,
      "postal_code": null,
      "country": null,
      "title": null,
      "company": null,
      "custom_fields": null,
      "required_fields": [
        "email",
        "first_name",
        "phone_number"
      ],
      "missing_fields": [
        "phone_number"
      ],
      "required_read_only_fields": [
        {
          "variable_name": "contract_amount",
          "field_type": "number",
          "has_value": false
        }
      ],
      "ready_to_send": false
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.firma.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key for authentication. Use your API key directly without any prefix (e.g., 'your-api-key'). Bearer prefix is optional but not required.

Path Parameters

id
string<uuid>
required

Signing request ID

Response

Signing request users retrieved successfully

results
object[]