## Update a customer's verification status

`$ straddle customers:review decision`

**patch** `/v1/customers/{id}/review`

Updates the status of a customer's identity decision. This endpoint allows you to modify the outcome of a customer risk screening and is useful for correcting or updating the status of a customer's verification. Note that this endpoint is only available for customers with a current status of `review`.

### Parameters

- `--id: string`

  Path param

- `--status: "verified" or "rejected"`

  Body param: The final status of the customer review.

- `--correlation-id: optional string`

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

- `--idempotency-key: optional string`

  Header param: Optional client generated value to use for idempotent requests.

- `--request-id: optional string`

  Header param: Optional client generated identifier to trace and debug a request.

- `--straddle-account-id: optional string`

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

### Returns

- `customerV1: object { data, meta, response_type }`

  - `data: object { id, created_at, email, 11 more }`

    - `id: string`

      Unique identifier for the customer.

    - `created_at: string`

      Timestamp of when the customer record was created.

    - `email: string`

      The customer's email address.

    - `name: string`

      Full name of the individual or business name.

    - `phone: string`

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

    - `status: "pending" or "review" or "verified" or 2 more`

      - `"pending"`

      - `"review"`

      - `"verified"`

      - `"inactive"`

      - `"rejected"`

    - `type: "individual" or "business"`

      - `"individual"`

      - `"business"`

    - `updated_at: string`

      Timestamp of the most recent update to the customer record.

    - `address: optional object { address1, city, state, 2 more }`

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

      - `address1: string`

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

      - `city: string`

        City, district, suburb, town, or village.

      - `state: string`

        Two-letter state code.

      - `zip: string`

        Zip or postal code.

      - `address2: optional string`

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

    - `compliance_profile: optional object { dob, ssn }  or object { ein, legal_business_name, representatives, website }`

      PII required to trigger Patriot Act compliant KYC verification.

      - `Individual Compliance Profile: object { dob, ssn }`

        PII required to trigger Patriot Act compliant KYC verification.

        - `dob: string`

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

        - `ssn: string`

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

      - `Business Compliance Profile: object { ein, legal_business_name, representatives, website }`

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

        - `ein: string`

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

        - `legal_business_name: string`

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

        - `representatives: optional array of object { name, email, phone }`

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

          - `name: string`

          - `email: optional string`

          - `phone: optional string`

        - `website: optional string`

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

    - `config: optional object { processing_method, sandbox_outcome }`

      - `processing_method: optional "inline" or "background" or "skip"`

        - `"inline"`

        - `"background"`

        - `"skip"`

      - `sandbox_outcome: optional "standard" or "verified" or "rejected" or "review"`

        - `"standard"`

        - `"verified"`

        - `"rejected"`

        - `"review"`

    - `device: optional object { ip_address }`

      - `ip_address: string`

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

    - `external_id: optional string`

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

    - `metadata: optional map[string]`

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

  - `meta: object { api_request_id, api_request_timestamp }`

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

    - `api_request_id: string`

      Unique identifier for this API request, useful for troubleshooting.

    - `api_request_timestamp: string`

      Timestamp for this API request, useful for troubleshooting.

  - `response_type: "object" or "array" or "error" or "none"`

    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"`

    - `"array"`

    - `"error"`

    - `"none"`

### Example

```cli
straddle customers:review decision \
  --api-key 'My API Key' \
  --id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e \
  --status verified
```

#### 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"
}
```