# Extras

Approved bought-in parts that your SKUs ship with.

## Endpoints

-   [GET `/v1/print-farm/extras`](https://public-api.dapi.digital/docs/reference/print-farm-extras.md#listPrintFarmExtras)
-   [GET `/v1/print-farm/extras/{id}`](https://public-api.dapi.digital/docs/reference/print-farm-extras.md#getPrintFarmExtra)

## The extra object

### Attributes

-   `id` (string): Opaque public identifier for this extra (`xtr_` prefix + 33 base62 chars). Use this value verbatim when referencing the extra in other endpoints.
-   `name` (string): Display name of the extra.
-   `purchase_links` (array of string): List of URLs where the extra can be purchased.
-   `description` (object, optional): Free-text description of the extra.
-   `price` (object, optional): Unit price in USD, as a string to preserve precision.

**The extra object**

```json
{
  "id": "xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh",
  "name": "M3 screws (set of 4)",
  "purchase_links": [
    "https://example.com/m3-screws"
  ],
  "description": "Pack of four M3×10mm steel screws.",
  "price": "1.50"
}
```

## List approved extras visible to your farm

GET `/v1/print-farm/extras`

- **Credentials**: An API key with the `SKU` or `FULL` permission.

- **For**: Print farms

- **Operation id**: `listPrintFarmExtras`

Returns a paginated list of approved extras reachable from your farm. An extra is visible iff it is referenced in `extra_list` of a SKU that appears in one of your allocated orders, or in a SKU whose stock is held at one of your farms. Extras outside that chain are not returned. Requires an API key with the `SKU` (or `FULL`) permission scope.

### Query parameters

-   `page` (integer): 1-based page index.
    
    Range at least 1. Defaults to 1.
    
-   `page_size` (integer): Page size (max 100).
    
    Range 1 to 100. Defaults to 20.
    
-   `id` (array of string): Filter by extra id. Accepts a comma-separated list of UUIDs.
-   `name` (string): Filter by extra name (case-insensitive partial match).

### Returns 200 OK

Paginated list of approved extras visible to the authenticated farm.

Response attributes (ListPrintFarmExtrasResponseDto):

-   `extras` (array of PrintFarmExtraResponseDto): Approved extras on this page, sorted by creation date (newest first).
    
    Described in [the extra object](https://public-api.dapi.digital/docs/reference/print-farm-extras.md#farm_extra_object).
    
-   `page` (number): Page number returned, matching the `page` query parameter.
    
    Range at least 1.
    
-   `page_size` (number): Number of items per page, matching the `page_size` query parameter.
    
    Range 1 to 100.
    
-   `total` (number): Total number of approved extras across all pages.
    
    Range at least 0.
    

### Responses

-   `200`: Paginated list of approved extras visible to the authenticated farm.
-   `400`: `page` or `page_size` is outside the allowed range.
-   `401`: API key is missing or invalid.
-   `403`: The API key does not have the required permission scope.
-   `429`: Rate limit exceeded - wait until the window resets before retrying.
-   `500`: An unexpected error occurred on our side.

Errors use [the print farm error body](https://public-api.dapi.digital/docs/guides/print-farm-quickstart.md#errors).

**Request**

```bash
curl "https://public-api.dapi.digital/v1/print-farm/extras" \
  -H "x-api-key: $DAPI_API_KEY"
```

**Response 200**

```json
{
  "extras": [
    {
      "id": "xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh",
      "name": "M3 screws (set of 4)",
      "purchase_links": [
        "https://example.com/m3-screws"
      ],
      "description": "Pack of four M3×10mm steel screws.",
      "price": "1.50"
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 42
}
```

## Get one approved extra visible to your farm

GET `/v1/print-farm/extras/{id}`

- **Credentials**: An API key with the `SKU` or `FULL` permission.

- **For**: Print farms

- **Operation id**: `getPrintFarmExtra`

Returns the approved extra matching the given `id`, scoped to extras reachable from your farm via the SKU graph (orders ∪ stock\_levels). Requires an API key with the `SKU` (or `FULL`) permission scope.

### Path parameters

-   `id` (string, required): The public extra identifier (`xtr_…`) returned by the list endpoint.

### Returns 200 OK

The requested extra. Returns [the extra object](https://public-api.dapi.digital/docs/reference/print-farm-extras.md#farm_extra_object).

### Responses

-   `200`: The requested extra.
-   `401`: API key is missing or invalid.
-   `403`: The API key does not have the required permission scope.
-   `404`: No approved extra with this `id` is visible to your farm (it may exist in the catalog but isn't reachable via any of your orders or stock\_levels).
-   `429`: Rate limit exceeded - wait until the window resets before retrying.
-   `500`: An unexpected error occurred on our side.

Errors use [the print farm error body](https://public-api.dapi.digital/docs/guides/print-farm-quickstart.md#errors).

**Request**

```bash
curl "https://public-api.dapi.digital/v1/print-farm/extras/xtr_mW2yH7cVjPq8rT5dN3kFx9eL4bA1uZcRh" \
  -H "x-api-key: $DAPI_API_KEY"
```

---

3DAPI API Docs. This page on the web: https://public-api.dapi.digital/docs/reference/print-farm-extras. Index of every page: https://public-api.dapi.digital/docs/llms.txt.
