Get Contact By Id

GET

/v1/contacts/{{contactId}}

Fetches a single contact's full details by its GUID, scoped to the calling workspace.

If the contact doesn't exist, or belongs to a different workspace → a real 404 Not Found with a proper error body (an ABP EntityNotFoundException), not a generic masked 500.

If found → returns the full contact, the same ContactDto shape used everywhere else (includes customProperties, notes, etc.).

Request

None

Responses

🟢200OK

application/json

Returns the full contact.

Bodyapplication/json

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://api.voxa.sa/v1/contacts/{{contactId}}'

Response Example

200 - Success Example

{
    "workspaceId": "d307b8...............",
    "name": "Ahmed Noshy",
    "phoneNumber": "+966501234567",
    "contactType": 1,
    "email": "Noshy@hatif.io",
    "company": "HATIF Co",
    "position": "Product Engineer",
    "customFields": {
        "source": "landing-page"
    },
    "notes": [],
    "customProperties": [],
    "lastModificationTime": "2026-06-19T14:21:51.848705",
    "lastModifierId": null,
    "creationTime": "2026-06-09T08:05:17.467676",
    "creatorId": null,
    "id": "3a21bd..............."
}

Modified at 2026-06-19 18:38:32

Get Contacts

Create Bulk Contacts vCards