Clients

Get a client

Retrieve a single client by ID.

get/v1/clients/{clientId}

Request

  • Base URL: https://api.frihet.io
  • URL: https://api.frihet.io/v1/clients/{clientId}
  • Auth: API key in header X-API-Key

Path parameters

clientIdstring required

Client unique identifier

Query parameters

fieldsstring
Example:id,name,total

Comma-separated list of fields to include in the response. The id field is always included. Example: fields=id,name,total

Response

Client details

idstring

Unique identifier

createdAtstring date-time
updatedAtstring date-time
namestring required

Client name (person or company)

emailstring email

Contact email

phonestring

Phone number

taxIdstring

Tax identification number (NIF/CIF/VAT)

integrationSource'hubspot' | 'pipedrive' | 'intercom' | 'mailchimp'

Source integration when the client is imported from an external CRM or marketing tool.

Example response

{
  "name": "Acme Corp",
  "email": "billing@acme.com",
  "phone": "+34 912 345 678",
  "taxId": "B12345678",
  "address": {
    "street": "Calle Gran Via 28",
    "city": "Madrid",
    "province": "Madrid",
    "zip": "28013",
    "country": "ES"
  },
  "nextAction": {
    "title": "Call to validate the accepted quote",
    "dueDate": "2026-07-10"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.