---
title: "Get customer by Customer ID"
method: GET
path: "/customers/{customerId}"
tags: ["Customers"]
---

# Get customer by Customer ID

`GET /customers/{customerId}`

## Request

- Base URL: `https://api.trueaccord.com/api/v1`
- URL: `https://api.trueaccord.com/api/v1/customers/{customerId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/trueaccord/apis/trueaccord-api/docs/customers/:customerId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a customer object with the given TrueAccord `CUSTOMER_ID`. (Note: the CUSTOMER_ID appears in the `meta` field of the Customer object that was returned when you added the customer. The CUSTOMER_ID also appears in the GET https://api.trueaccord.com/api/v1/customers/ response.)

## Response `200`

Ok

- Customer: For best results, you should specify as many fields as possible in the Customers object. Besides the above mandatory fields, all other fields are optional. If you have no value to supply for a field, you can omit it in your request.
  - `meta` Meta
    - `id` string
    - `isActive` boolean: Indicates whether an object is active in the system. If a customer or a debt are inactive, our system will not attempt to collect them.
    - `isPrimary` boolean: If the object appears in a list of objects (like emails, or phones) this indicates whether that object has priority over others. There can be at most one primary object in a list.
    - `timeCreated` integer: Milliseconds since Jan 1st, 1970 UTC.
    - `lastModified` integer: Milliseconds since Jan 1st, 1970 UTC.
  - `name` object, required
    - `firstName` string, required
    - `middleName` string
    - `lastName` string, required
  - `dateOfBirth` Date
    - `day` integer: Day of the calendar year.
    - `month` integer: Month of calendar year.
    - `year` integer: Calendar year.
  - `businesses` object[]: Use the `businesses` array to provide one or more businesses names associated with this customer.
    - `name` string
    - `url` string
  - `addresses` object[]
    - `streetLine1` string
    - `streetLine2` string
    - `city` string, required
    - `state` string, required
    - `zipcode` string, required
    - `countryCode` string, required
    - `types` string[]
  - `phones` object[]
    - `phoneNumber` string, required
    - `types` string[]: Can contain the following strings: 'HOME', 'WORK', 'CELL', 'FAX', or 'BUSINESS'. The types argument can be left blank if context doesn't exist.
  - `emails` object[]
    - `email` string, required
    - `types` string[]: Can contain the following strings: 'HOME' or 'WORK'
  - `comments` object[]: The `comments` array can be used to provide us with context you may have about this customer.
    - `comment` string, required
  - `reference` string: The reference is a string used to attach your (client's) system's customer unique ID to this object.
  - `debts` Debt[]
    - `biller` string: For aggregators and marketplaces: this field stores the name of your sub merchant.
    - `product` string: description of the product or service associated with this debt.
    - `initialPrincipal` MonetaryAmount
      - `amount` integer
      - `currency` string
    - `initialInterest` MonetaryAmount
      - `amount` integer
      - `currency` string
    - `initialFees` MonetaryAmount
      - `amount` integer
      - `currency` string
    - `postChargeOffInformation` PostChargeOffInformation: information relevant for post charge-off debts. Required for accounts in the state of NY.
      - `balanceAtChargeOff` MonetaryAmount
        - `amount` integer
        - `currency` string
      - `chargeOffTimestamp` integer: Milliseconds since Jan 1st, 1970 UTC.
      - `feesAccruedSinceChargeOff` MonetaryAmount
        - `amount` integer
        - `currency` string
      - `interestAccruedSinceChargeOff` MonetaryAmount
        - `amount` integer
        - `currency` string
      - `totalPaidSinceChargeOff` MonetaryAmount
        - `amount` integer
        - `currency` string
    - `transactionId` string: arbitrary string that you can use to store a reference to the transaction on your system.
    - `transactionIp` string: IP address associated with this transaction. Either in IPv4 or IPv6 format.
    - `transactionTimestamp` integer: time that the transaction leading to the debt occurred, if applicable. Format: milliseconds since Jan 1st, 1970 UTC. For example, the origination date of the loan or the date the customer purchased the product which led to the debt. This should be **before** the `defaultTimestamp`. Note that this date may be shown to the customer to provide context on the debt, and also has ramifications in our system's compliance rules.
    - `defaultTimestamp` integer: Milliseconds since Jan 1st, 1970 UTC.
    - `accountOpenTimestamp` integer: Milliseconds since Jan 1st, 1970 UTC.
    - `clientFields` object: Client-specific key-value pairs.
    - `sendCbrNegativeNotice` boolean: Boolean flag indicating whether a negative notice **WILL BE** submitted to a credit bureau in the future.
    - `hasSentCbrNegativeNotice` boolean: Boolean flag indicating whether a negative notice **HAS BEEN** submitted to a credit bureau in the past.
  - `ssn` string

---

[API](https://skmtc.dev/trueaccord/apis/trueaccord-api.md) - [All operations](https://skmtc.dev/trueaccord/apis/trueaccord-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trueaccord/apis/trueaccord-api/revisions/93d3c0ce897d?raw)