Skip to main content
GET /api/v1/forward/identities Returns Identity records owned by the authenticated account.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

​
Query parameters

ParameterTypeRequiredDefaultDescription
external_idstringNo-Filter by the integrator’s end-user ID.
limitintegerNo20Items per page. Maximum 100. Values above 100 return HTTP 400.
after_idstringNo-Cursor for the next page. Cannot be used with before_id.
before_idstringNo-Cursor for the previous page. Cannot be used with after_id.

​
Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities?external_id=user_456&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "id": "idn_019eabc123",
      "external_id": "user_456",
      "name": "Example User",
      "enabled": true,
      "metadata": {},
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "idn_019eabc123",
  "last_id": "idn_019eabc123",
  "has_more": false
}

​
Response fields

FieldTypeDescription
dataarrayIdentity objects on the current page.
first_idstring|nullID of the first record on this page.
last_idstring|nullID of the last record on this page.
has_morebooleanWhether more records remain.

​
Errors

HTTPTypeTrigger
400invalid_request_errorInvalid pagination parameters or limit above 100.
401authentication_errorPAT invalid or expired.
403permission_errorNot authorized for this resource.

​
Notes

  • after_id and before_id are mutually exclusive.
  • Soft-deleted identities are not intended for normal use.

Create an identity

Get an identity