Customers

Get a customer

Retrieves the complete details of a customer.

  • Deprecated: use GET /v1/companies/{company_id}/customers/{customer_id}, which behaves identically.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

get/v1/customers/{customer_id}

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/customers/{customer_id}
  • Auth: HTTP bearer

Path parameters

customer_idstring uuid required

Universally Unique Identifier (UUID v4)

Example:550e8400-e29b-41d4-a716-446655440000

Customer ID

Response

Customer retrieved successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "legal_name": "Empresa Cliente SL",
    "trade_name": "EmpresaCliente",
    "nif": "12345678A",
    "address": {
      "street": "Calle Mayor, 123",
      "number": "123",
      "floor": "2º A",
      "door": "A",
      "postal_code": "28001",
      "city": "Madrid",
      "province": "Madrid",
      "country": "España",
      "country_code": "ES"
    },
    "phone": "+34 612 345 678",
    "billing_emails": [
      "user@example.com"
    ],
    "contact_person": "María García",
    "preferred_payment_method": {
      "method": "BANK_TRANSFER",
      "iban": "ES1234567890123456789012",
      "swift": "ABCDESMMXXX",
      "payment_term_days": 30
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

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