# Products

Received Products' APIs allow our users to manage their products and pricing models. The APIs support operations such as creating new products and pricing models, updating existing products, and fetching products to use in customer contracts and subscriptions.

{% code title="Endpoint on this page" lineNumbers="true" %}

```javascript
GET https://api.received.ai/api/products
```

{% endcode %}

{% hint style="info" %}
Don't forget! APIs must include:

1. **Bearer Token** - return from the login call
2. **API version** - {"Version": "V0"}
   {% endhint %}

## Getting Products and Pricing

Fetching products and pricing provides detailed listings of available offerings and their associated costs. This information is crucial to build a contract, tailor their purchase orders, and negotiate contracts effectively.

### Get Products

{% code lineNumbers="true" %}

```javascript
GET https://api.received.ai/api/products
```

{% endcode %}

#### Response

{% code lineNumbers="true" %}

```javascript
[
    {
      "pricing_ref": "35bfdd59-6462-4ec6-bd7b-b3e654d85774",
      "product_name": "Subscriptions",
      "pricing_name": "Plans",
      "line_items": [
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f689"
          "item": "Starter",
          "price": 3000,
          "quantity": 1,
          "amount": 3000
        },
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f680"
          "item": "Professional",
          "price": 6000,
          "quantity": 1,
          "amount": 6000
        },
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f681"
          "item": "Organization",
          "price": 9000,
          "quantity": 1,
          "amount": 9000
        }
      ]
    },
    {
      "pricing_ref": "946ba17b-6f16-491e-bfa3-d189e827a9a3",
      "product_name": "Pay-as-you-go",
      "pricing_name": "Tiered",
      "line_items": [
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f682"
          "item": "Starter",
          "price": 10,
          "quantity": 0,
          "amount": 0
        },
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f683"
          "item": "Professional",
          "price": 9,
          "quantity": 0,
          "amount": 0
        },
        {
          "line_item_ref": "e72dd70c-cc65-4804-af2f-2fe6dab5f684"
          "item": "Organization",
          "price": 8,
          "quantity": 0,
          "amount": 0
        }
      ]
    }
]
```

{% endcode %}

#### Response Schema

Return list of pricing model with a product as a property. Those pricing and their lineitems can be used to build a contract (see [Contract page](https://docs.received.ai/api-docs/contracts))

**Pricing Schema**

<table><thead><tr><th width="201">Term</th><th width="99">Type</th><th width="330">Description </th><th width="378">Example</th></tr></thead><tbody><tr><td><code>pricing_ref</code></td><td><mark style="color:purple;">String</mark></td><td>The ID of the related product pricing</td><td>35bfdd59-6462-4ec6-bd7b-b3e654d85774</td></tr><tr><td><code>product_name</code></td><td><mark style="color:purple;">String</mark></td><td>The pricing's related product</td><td>Subscription</td></tr><tr><td><code>pricing_name</code></td><td><mark style="color:purple;">String</mark></td><td>Name of the pricing</td><td>Plans</td></tr><tr><td><code>line_items</code></td><td><mark style="color:purple;">Array</mark></td><td>List of pricing related lineitems</td><td></td></tr></tbody></table>

**Lineitem Schema**

<table><thead><tr><th width="350">Term</th><th width="99">Type</th><th width="330">Description </th><th width="378">Example</th></tr></thead><tbody><tr><td><code>line_item_ref</code></td><td><mark style="color:purple;">String</mark></td><td>The ID of the related lineitem</td><td>e72dd70c-cc65-4804-af2f-2fe6dab5f689</td></tr><tr><td><code>item</code></td><td><mark style="color:purple;">String</mark></td><td>Item name</td><td>Starter</td></tr><tr><td><code>price</code></td><td><mark style="color:purple;">String</mark></td><td>Item price</td><td>30000</td></tr><tr><td><code>quantity</code></td><td><mark style="color:purple;">String</mark></td><td>Item quantity</td><td>1</td></tr><tr><td><code>amount</code></td><td><mark style="color:purple;">Array</mark></td><td>Total amount of the item</td><td>3000</td></tr></tbody></table>