Skip to main content

List Identity configs

List Template-specific configs for an Identity.

Request headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID.

Query parameters

ParameterTypeRequiredDefaultDescription
template_idstringNo-Filter by Forward Template ID.
statusstringNoactiveFilter by active or archived.
limitintegerNo20Items per page. Maximum 100.
after_idstringNo-Cursor from the previous response's last_id. Cannot be used with before_id.
before_idstringNo-Cursor from the previous response's first_id. Cannot be used with after_id.

Example request

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

Example response

HTTP 200 OK 
{
  "data": [
    {
      "type": "config",
      "id": "cfg_support",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "CRM profile",
      "status": "active",
      "effective_hash": "sha256:...",
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "cfg_support",
  "last_id": "cfg_support",
  "has_more": false
}

Response fields

Field

Type

Description

data

array

Config summary objects on the current page.

first_id

string|null

ID of the first config on this page.

last_id

string|null

ID of the last config on this page.

has_more

boolean

Whether more records remain.

Errors

HTTPTypeTrigger
400invalid_request_errorInvalid pagination parameters.
401authentication_errorPAT invalid or expired.
404not_found_errorIdentity does not exist or is not visible to the caller.

Notes

  • Cursor values come from Identity Config IDs, not Template IDs.
  • An Identity can have at most one active config for a given Template.