Retrieve the full details of a single identity using its UUID.
Path parameters
The UUID of the identity to retrieve.
Response
Unique identifier for the identity (UUID).
The provisioned email channel, or null if no email was provisioned.
The full email address (e.g., agent@agentmail.to).
The provider that issued the email address (e.g., AGENTMAIL).
The provisioned phone channel, or null if no phone was provisioned.
The full phone number in E.164 format (e.g., +14155550100).
The provider that issued the phone number (e.g., AGENTPHONE).
The provisioned virtual card channel, or null if no card was provisioned.
An opaque token referencing the virtual card at the issuer. Use this to identify the card without storing sensitive card details.
The provider that issued the virtual card (e.g., PRIVACY).
Errors
| Status | Description |
|---|
404 | No identity found with the given ID. |
curl https://api.agentity.to/identities/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer YOUR_JWT"
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"email": {
"address": "my-agent-001@agentmail.to",
"issuer": "AGENTMAIL"
},
"phone": {
"number": "+14155550100",
"issuer": "AGENTPHONE"
},
"virtualCard": {
"token": "tok_sandbox_abc123",
"issuer": "PRIVACY"
}
}