v1

latestOpenAPI 3.0.12026-07-141671231.8 MB
Customers

Retrieve a customer

This endpoint returns a customer.

ℹ️ This endpoint requires one of the following scopes: customers:all, customers:readonly

get/api/external/v2/customers/{id}

Path parameters

idinteger required

Customer identifier

Response

Returns a company customer

OR

Example response

{
  "id": 42,
  "name": "My company",
  "billing_iban": "FR1420041010050500013M02606",
  "recipient": "John Doe",
  "phone": "+33612345678",
  "reference": "REF-1234",
  "notes": "Some notes",
  "vat_number": "FR12345678901",
  "reg_no": "123456789",
  "emails": [
    "hello@example.org"
  ],
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z",
  "external_reference": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a",
  "mandates": {
    "url": "https://app.pennylane.com/api/external/v2/gocardless_mandates?filter=%5B%7B%5C\"field%5C\":%5C\"customer_id%5C\",%5C\"operator%5C\":%5C\"eq%5C\",%5C\"value%5C\":%5C\"42%5C\"%7D%5D"
  },
  "pro_account_mandates": {
    "url": "https://app.pennylane.com/api/external/v2/pro_account/mandates?filter=%5B%7B%22field%22%3A%22customer_id%22%2C%22operator%22%3A%22eq%22%2C%22value%22%3A%2242%22%7D%5D"
  },
  "contacts": {
    "url": "https://app.pennylane.com/api/external/v2/customers/42/contacts"
  }
}