## Lookup a customer

`CustomerV1 Customers.Get(CustomerGetParamsparameters, CancellationTokencancellationToken = default)`

**get** `/v1/customers/{id}`

Retrieves the details of an existing customer. Supply the unique customer ID that was returned from your 'create customer' request, and Straddle will return the corresponding customer information.

### Parameters

- `CustomerGetParams parameters`

  - `required string id`

  - `string correlationID`

    Optional client generated identifier to trace and debug a series of requests.

  - `string requestID`

    Optional client generated identifier to trace and debug a request.

  - `string straddleAccountID`

    For use by platforms to specify an account id and set scope of a request.

### Returns

- `class CustomerV1:`

  - `required Data Data`

    - `required string ID`

      Unique identifier for the customer.

    - `required DateTimeOffset CreatedAt`

      Timestamp of when the customer record was created.

    - `required string Email`

      The customer's email address.

    - `required string Name`

      Full name of the individual or business name.

    - `required string Phone`

      The customer's phone number in E.164 format.

    - `required Status Status`

      - `"pending"Pending`

      - `"review"Review`

      - `"verified"Verified`

      - `"inactive"Inactive`

      - `"rejected"Rejected`

    - `required Type Type`

      - `"individual"Individual`

      - `"business"Business`

    - `required DateTimeOffset UpdatedAt`

      Timestamp of the most recent update to the customer record.

    - `CustomerAddressV1? Address`

      An object containing the customer's address. This is optional, but if provided, all required fields must be present.

      - `required string Address1`

        Primary address line (e.g., street, PO Box).

      - `required string City`

        City, district, suburb, town, or village.

      - `required string State`

        Two-letter state code.

      - `required string Zip`

        Zip or postal code.

      - `string? Address2`

        Secondary address line (e.g., apartment, suite, unit, or building).

    - `ComplianceProfile? ComplianceProfile`

      PII required to trigger Patriot Act compliant KYC verification.

      - `class IndividualComplianceProfile:`

        PII required to trigger Patriot Act compliant KYC verification.

        - `required DateOnly? Dob`

          Masked date of birth in ****-**-** format.

        - `required string? Ssn`

          Masked Social Security Number in the format ***-**-*\***.

      - `class BusinessComplianceProfile:`

        Business registration data required to trigger Patriot Act compliant KYB verification.

        - `required string? Ein`

          Masked Employer Identification Number in the format **-**\*****

        - `required string? LegalBusinessName`

          The official registered name of the business. This name should be correlated with the `ein` value.

        - `IReadOnlyList<Representative>? Representatives`

          A list of people related to the company. Only valid where customer type is 'business'.

          - `required string Name`

          - `string? Email`

          - `string? Phone`

        - `string? Website`

          Official business website URL. Optional but recommended for enhanced KYB.

    - `Config Config`

      - `ProcessingMethod ProcessingMethod`

        - `"inline"Inline`

        - `"background"Background`

        - `"skip"Skip`

      - `SandboxOutcome SandboxOutcome`

        - `"standard"Standard`

        - `"verified"Verified`

        - `"rejected"Rejected`

        - `"review"Review`

    - `Device Device`

      - `required string IPAddress`

        The customer's IP address at the time of profile creation. Use `0.0.0.0` to represent an offline customer registration.

    - `string? ExternalID`

      Unique identifier for the customer in your database, used for cross-referencing between Straddle and your systems.

    - `IReadOnlyDictionary<string, string>? Metadata`

      Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the customer in a structured format.

  - `required ResponseMetadata Meta`

    Metadata about the API request, including an identifier and timestamp.

    - `required string ApiRequestID`

      Unique identifier for this API request, useful for troubleshooting.

    - `required DateTimeOffset ApiRequestTimestamp`

      Timestamp for this API request, useful for troubleshooting.

  - `required ResponseType ResponseType`

    Indicates the structure of the returned content.

    - "object" means the `data` field contains a single JSON object.
    - "array" means the `data` field contains an array of objects.
    - "error" means the `data` field contains an error object with details of the issue.
    - "none" means no data is returned.

    - `"object"Object`

    - `"array"Array`

    - `"error"Error`

    - `"none"None`

### Example

```csharp
CustomerGetParams parameters = new()
{
    ID = "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
};

var customerV1 = await client.Customers.Get(parameters);

Console.WriteLine(customerV1);
```

#### Response

```json
{
  "data": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created_at": "2019-12-27T18:11:19.117Z",
    "email": "ron.swanson@pawnee.com",
    "name": "Ron Swanson",
    "phone": "+12128675309",
    "status": "pending",
    "type": "individual",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "address": {
      "address1": "123 Main St",
      "city": "Anytown",
      "state": "CA",
      "zip": "12345",
      "address2": "Apt 1"
    },
    "compliance_profile": {
      "dob": "2019-12-27",
      "ssn": "***-**-****"
    },
    "config": {
      "processing_method": "inline",
      "sandbox_outcome": "standard"
    },
    "device": {
      "ip_address": "192.168.1.1"
    },
    "external_id": "external_id",
    "metadata": {
      "foo": "string"
    }
  },
  "meta": {
    "api_request_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "api_request_timestamp": "2019-12-27T18:11:19.117Z"
  },
  "response_type": "object"
}
```