WIwithflex
Customers

Retrieve a customer

Changed on

Retrieves the details of one of your customers.

get/v1/customers/{id}

Request

  • Base URL
    https://api.withflex.com
  • URL
    https://api.withflex.com/v1/customers/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA

Query parameters

include_orgboolean nullable

Resolve a customer owned by a sibling partner in the same organization (PII opt-in). Defaults to false; a customer owned by another partner returns 404 unless this is true and the caller shares an organization with the owner. The owner is named on the response's owner_partner_id, and a sibling-owned customer's metadata is returned as null.

Response

An envelope wrapping a single customer object.

Example response

{
  "customer": {
    "customer_id": "fcus_01HACM7FZ1084XB1GB6053VM0D",
    "owner_partner_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "first_name": "John",
    "last_name": "Doe",
    "email": "joh.doe@example.com",
    "phone": "+15555555555",
    "employer": "Flex",
    "shipping": {
      "shipping_address_id": "fsh_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
      "line1": "123 Main St",
      "line2": "Suite 100",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94107",
      "country": "US"
    },
    "metadata": {
      "order_id": "8842",
      "channel": "shopify"
    },
    "created_at": "2026-06-15T14:30:00Z",
    "test_mode": false
  }
}

Changes