Skip to main content
Retrieve all agent identities associated with your account. Results are returned in pages.

Query parameters

page
integer
default:"1"
The page number to retrieve.
pageSize
integer
default:"50"
The number of identities to return per page.

Response

identities
object[]
An array of identity objects.
page
integer
The current page number.
pageSize
integer
The number of results per page.
total
integer
The total number of identities across all pages.
curl https://api.agentity.to/identities \
  -H "Authorization: Bearer YOUR_JWT"
{
  "identities": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "agentId": "my-agent-001",
      "emailAddress": "my-agent-001@agentmail.to",
      "emailProvider": "AGENTMAIL",
      "phoneNumber": "+14155550100",
      "phoneProvider": "AGENTPHONE",
      "virtualCardToken": "tok_sandbox_abc123",
      "virtualCardProvider": "PRIVACY"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}