/api/p/v{version}/customers

The endpoint for retrieving customer details allows you to access a single customer record by providing either the customer ID or the company number. At least one of these parameters (id or companyNumber) must be included in the request, ensuring flexibility and ease of use. For more information on how versioning works and how to include it in your requests, please refer to the Versioning page.

Request Parameters

The following parameters are conditionally required in the URL:

Parameter	Type	Required	Description
id	String	Conditional	The unique identifier of the customer. Either `id` or `companyNumber` must be provided.
companyNumber	String	Conditional	The company number of the customer. Either `companyNumber` or `id` must be provided.

Example CURL Request

curl --location 'https://integrations.alvys.com/api/p/v1/customers?id=01fec4d332ed49ff96595c8d4434ea96' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

curl --location 'https://integrations.alvys.com/api/p/v1/customers?companyNumber=DLA87FOVA22060' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Replace YOUR_ACCESS_TOKEN with your actual Bearer token. Use either id or companyNumber as required.

Response Fields

The following fields are included in the response:

Field	Type	Description
Id	String	The unique identifier of the customer.
Name	String	The name of the customer.
CompanyNumber	String	The company number of the customer.
Type	String	The type of customer (e.g., "Customer").
Status	String	The status of the customer (e.g., "Active").
BillingAddress	Object	The billing address of the customer.
BillingAddress.Street	String	The street address of the billing location.
BillingAddress.City	String	The city of the billing address.
BillingAddress.State	String	The state of the billing address.
BillingAddress.ZipCode	String	The postal code of the billing address.
Email	Array	A list of email addresses associated with the customer.
Phone	Array	A list of phone numbers associated with the customer.
Fax	String	The fax number of the customer.
DateCreated	String (Date-Time)	The date and time when the customer was created.
InvoicingInformation	Object	The invoicing information for the customer.
InvoicingInformation.Address	Object	The address used for invoicing.
InvoicingInformation.Address.Street	String	The street address for invoicing.
InvoicingInformation.Address.City	String	The city of the invoicing address.
InvoicingInformation.Address.State	String	The state of the invoicing address.
InvoicingInformation.Address.ZipCode	String	The postal code of the invoicing address.
InvoicingInformation.EmailAddresses	Array	Email addresses used for invoicing.
InvoicingInformation.InvoicingName	String	The name used for invoicing.
InvoicingInformation.InvoicingNameAlias	String	The alias for the invoicing name.
ExternalIds	Array	A list of external IDs associated with the customer.
Contacts	Array	A list of contacts associated with the customer.
Notes	Array	A list of notes related to the customer.

Example Response

{
    "Id": "9b834b4c77124b8f8f0d97b56b7dabc4",
    "Name": "ACME Corporation / ACME-12345",
    "CompanyNumber": "ACME12345USA",
    "Type": "Customer",
    "Status": "Active",
    "BillingAddress": {
        "Street": "123 Elm Street",
        "City": "Springfield",
        "State": "IL",
        "ZipCode": "62704"
    },
    "Email": ["[email protected]"],
    "Phone": ["5551234567"],
    "Fax": "5557654321",
    "DateCreated": "2024-01-15T10:45:00.0000000+00:00",
    "InvoicingInformation": {
        "Address": {
            "Street": "123 Elm Street",
            "City": "Springfield",
            "State": "IL",
            "ZipCode": "62704"
        },
        "EmailAddresses": ["[email protected]"],
        "InvoicingName": "ACME Corporation / ACME-12345",
        "InvoicingNameAlias": "ACME Billing Dept"
    },
    "ExternalIds": ["EXT-001", "EXT-002"],
    "Contacts": [
        {
            "Name": "John Smith",
            "Phone": "5559876543",
            "Email": "[email protected]",
            "Role": "Billing Manager"
        }
    ],
    "Notes": [
        {
            "Id": "note-123",
            "Description": "Customer prefers electronic invoices.",
            "NoteType": "Preference",
            "Time": "2024-02-10T08:30:00.0000000+00:00",
            "User": "admin"
        }
    ]
}

Rate Limits

All endpoints are subject to rate limits to protect the API from traffic spikes. For detailed information on rate limits, please refer to the Rate Limits section.

This page is interactive, allowing you to try a request by completing the fields for the parameters below. As you fill out the parameters, the CURL command on the right side of the page will be automatically updated. Alternatively, you can fork our Public API Postman Collection directly. Make sure to authorize yourself before trying a request.