Get an identity

Retrieve a Forward identity by ID.

GET /api/v1/forward/identities/{identity_id}

Returns an Identity owned by the authenticated account.

Headers

Header	Required	Description
Authorization	Yes	Bearer <PAT>

Path parameters

Parameter	Type	Required	Description
identity_id	string	Yes	Forward Identity ID.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "id": "idn_019eabc123",
  "external_id": "user_456",
  "name": "Example User",
  "enabled": true,
  "metadata": {
    "channel": "web"
  },
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:00:00Z"
}

Response fields

Returns the Identity object.

Errors

HTTP	Type	Trigger
401	authentication_error	PAT invalid or expired.
403	permission_error	Not authorized for this resource.
404	not_found_error	Identity does not exist or is not visible to the caller.

Notes

• Disabled identities can still be retrieved.
• Deleted identities must not be used to create new sessions.

Related

Update an identity

List identity configs