Customers

A Customer is the entity responsible for funding card spending. Customers can be individuals (consumers) or businesses (corporate).

Customer Types

Type	Description
`consumer`	Individual person
`corporate`	Business entity

Creating a Customer

curl -X POST https://api.useproxy.ai/v1/customers \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "consumer",
    "email": "alice@example.com",
    "name": { "first": "Alice", "last": "Smith" }
  }'

Customer Fields

Field	Type	Description
`type`	string	`consumer` or `corporate`
`email`	string	Customer email address
`name`	object	First and last name (consumer) or business name (corporate)
`status`	string	KYC verification status

KYC Verification

Customers must complete KYC (Know Your Customer) verification before issuing cards. The verification status can be:

pending - Awaiting verification
verified - Approved for card issuance
rejected - Verification failed

Default Policies

Customers can set default spending policies that apply to all their agents and cards unless overridden.

{
  "policy": {
    "requireIntent": true,
    "autoApproveBelow": 10000,
    "limits": {
      "perDay": 50000
    }
  }
}

Next Steps

Agents

Create agents to spend on behalf of customers

Cards

Issue virtual cards

AgentsAutonomous actors that spend on behalf of customers

Getting Started

Concepts

Customers

Customers

Customer Types

Creating a Customer

Customer Fields

KYC Verification

Default Policies

Next Steps

Agents

Cards

​Customers

​Customer Types

​Creating a Customer

​Customer Fields

​KYC Verification

​Default Policies

​Next Steps

Agents

Cards

Customers

Customer Types

Creating a Customer

Customer Fields

KYC Verification

Default Policies

Next Steps