> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdr.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# Purchasers

> Create, update & list purchasers.

## List Purchasers

Retrieves a list of purchasers.

### HTTP Request

`GET https://api.cdr.fyi/v1/purchasers`

### Query Parameters

| Parameter        | Type   | Description                                              |
| ---------------- | ------ | -------------------------------------------------------- |
| entityFilterType | String | Filter by entity type (Supplier, Marketplace, Purchaser) |
| entityFilterId   | String | Filter by entity ID                                      |

### Custom Headers

* `x-page`: The page number (default is 1)
* `x-limit`: Number of items per page (max 100, default is 10)

## Example Request

````bash theme={null}
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.cdr.fyi/purchasers?entityFilterType=Purchaser&entityFilterId=123"


### Create or Update a Purchaser

This endpoint creates a new purchaser or updates an existing one by upserting based on the `purchaser_id`.

#### HTTP Request

`POST https://api.cdr.fyi/v1/purchasers`

#### Request Headers

- **Authorization**: Bearer YOUR_ACCESS_TOKEN
- **Content-Type**: application/json

#### Request Body Parameters

| Parameter          | Type     | Description                                          | Required |
|--------------------|----------|------------------------------------------------------|----------|
| purchaser_id       | String   | Unique identifier for the purchaser                  | No       |
| name               | String   | Name of the purchaser                                | Yes      |
| methods            | String   | Payment methods available                            | No       |
| website            | String   | Website URL                                          | No       |
| logo               | String   | Logo URL                                             | No       |
| slug               | String   | URL slug                                             | No       |
| tagline            | String   | Tagline                                              | No       |
| description        | String   | Description (max 500 characters)                     | No       |
| year_founded       | Integer  | Year founded                                         | No       |
| geo_city           | String   | Geographic city                                      | No       |
| geo_country        | String   | Geographic country                                   | No       |
| twitter            | String   | Twitter handle                                       | No       |
| is_verified        | Boolean  | Verification status                                  | No       |

Example Request
```bash
curl -X GET https://api.cdr.fyi/v1/purchasers \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" 
````

Example Response

```json theme={null}
{
  "purchasers": [{
    "purchaser_id": "pur_sample",
    "name": "Sample Purchaser",
    "methods": "Wire Transfer",
    "website": "https://sample.com",
    "logo": "https://sample.com/logo.png",
    "slug": "sample-purchaser",
    "tagline": "The best purchaser",
    "description": "This is a sample purchaser",
    "year_founded": 2005,
    "geo_city": "London",
    "geo_country": "UK",
    "twitter": "@sample",
    "is_verified": true
  }]
}
```

## Error Responses

If the request is not successful, you will receive a 400 Bad Request or 401 Unauthorized response along with an error message indicating the issue.