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

# Vendor API Scopes

> The following table specifies the scopes required to access the Vendors API endpoints:

| Operation               | Scopes        |
| :---------------------- | :------------ |
| Create a new vendor     | vendors:write |
| Fetch a list of vendors | vendors:read  |
| Retrieve a vendor       | vendors:read  |
| Update a vendor         | vendors:write |
| Archive a vendor        | vendors:write |
| Post a vendor status    | vendors:write |

<Info>
  ⚠️ **Note: At the moment, the vendor records are stored at the company level.**

  Hence, if any customer has multiple entities (Organisation level), they would need to use the `company_id` to send request to a specific entity of the organisation.
</Info>