Skip to main content
GET
/
api
/
contacts
List Contacts
curl --request GET \
  --url https://qwoty.app/api/contacts \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "workspace_id": "706eb564-6c4a-4e18-841c-bdd79be6bca7",
      "customer_id": "550e8400-e29b-41d4-a716-446655440000",
      "first_name": "Jean",
      "last_name": "Dupont",
      "email": "jean.dupont@acme.com",
      "phone": "+33 6 12 34 56 78",
      "role": ["buyer", "signer"],
      "id_crm": null,
      "id_erp": null,
      "id_accounting": null,
      "address_ids": ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer qwoty_your_token

​
Query Parameters

​
customer_id
string
Filter contacts by customer UUID

​
Examples

curl "https://qwoty.app/api/contacts?customer_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer qwoty_your_token"

​
Response

​
success
boolean
true if the request succeeded
​
data
array
Array of contact objects
{
  "success": true,
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "workspace_id": "706eb564-6c4a-4e18-841c-bdd79be6bca7",
      "customer_id": "550e8400-e29b-41d4-a716-446655440000",
      "first_name": "Jean",
      "last_name": "Dupont",
      "email": "jean.dupont@acme.com",
      "phone": "+33 6 12 34 56 78",
      "role": ["buyer", "signer"],
      "id_crm": null,
      "id_erp": null,
      "id_accounting": null,
      "address_ids": ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}