👥 Contacts API

Manage contacts including clients, opposing parties, courts, and other entities your firm interacts with.

Contact Object

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "client",
  "firstName": "Jan",
  "lastName": "Janssens",
  "email": "jan@example.be",
  "phone": "+32 2 123 45 67",
  "company": "Janssens BV",
  "vatNumber": "BE0123456789",
  "address": {
    "street": "Voorbeeldstraat 1",
    "city": "Brussel",
    "postalCode": "1000",
    "country": "BE"
  },
  "firmId": "firm-uuid-here",
  "createdAt": "2026-01-15T10:00:00Z"
}

Fields

Field	Type	Description
id	string	Unique identifier (UUID)
type	string	client, opposing_party, opposing_counsel, court, expert, other
firstName	string	First name (individuals)
lastName	string	Last name (individuals)
company	string	Company name (if applicable)
email	string	Email address
phone	string	Phone number
vatNumber	string	VAT/enterprise number
address	object	Address details

List Contacts

GET /api/contacts

Query Parameters

Parameter	Type	Description
type	string	Filter by contact type

Example

GET /api/contacts?type=client

Response:
{
  "success": true,
  "data": [
    {
      "id": "...",
      "firstName": "Jan",
      "lastName": "Janssens",
      "type": "client",
      ...
    }
  ]
}

Get Contact

GET /api/contacts/{id}

Create Contact

POST /api/contacts

Request Body

{
  "type": "client",
  "firstName": "Marie",
  "lastName": "Dupont",
  "email": "marie@example.be",
  "phone": "+32 2 987 65 43",
  "address": {
    "street": "Rue de la Loi 100",
    "city": "Bruxelles",
    "postalCode": "1000",
    "country": "BE"
  }
}

Response

{
  "success": true,
  "data": {
    "id": "newly-generated-uuid",
    "type": "client",
    "firstName": "Marie",
    "lastName": "Dupont",
    ...
  }
}

Update Contact

PUT /api/contacts/{id}

Request Body

{
  "type": "client",
  "firstName": "Marie",
  "lastName": "Dupont-Janssens",
  "email": "marie.new@example.be",
  "phone": "+32 2 987 65 43"
}

Delete Contact

DELETE /api/contacts/{id}

Response

{
  "success": true
}

← Back to API Overview