---
title: "pricelists2accounts"
description: "REST API endpoints for pricelists2accounts."
canonical_url: "https://www.zeyos.com/api/pricelists-2-accounts"
markdown_url: "https://www.zeyos.com/ai/guide/api/pricelists-2-accounts.md"
section: "api-reference"
authority: "reference"
language: "en"
source_repository: "https://cloud.zeyos.com/__doc/openapi/api.json"
source_sha256: "f5850c6fa6f99a1b518fc8ddc4e566070b53b5506cde57a3299948d38fc6363c"
---

# ZeyOS Standard REST API (v1)

## Tag: pricelists2accounts
Pricelists-to-accounts

## Spec
- /__doc/openapi/api.json

## Servers
- https://cloud.zeyos.com/{INSTANCE}/api/v1 — ZeyOS Cloud

## Authentication
- oauth (oauth2) — OAuth 2.0 Authorization ([RFC 6749](https://tools.ietf.org/html/rfc6749)); use the **[ZeyOS OAuth 2.0 API](https://developers.zeyos.com/oauth2) `POST /oauth2/v1/token`** to obtain a valid bearer token
- token (http) — HTTP Bearer Authentication ([RFC 6750](https://tools.ietf.org/html/rfc6750))
- session (apiKey) — Session Cookie Authentication ([RFC 6265](https://tools.ietf.org/html/rfc6265))

## Endpoints
| Method | Path | Summary |
| ------ | ---- | ------- |
| POST | /pricelists2accounts | List pricelists-to-accounts |
| PUT | /pricelists2accounts | Create new price |
| DELETE | /pricelists2accounts/{ID} | Delete price |
| GET | /pricelists2accounts/{ID} | Get price |
| HEAD | /pricelists2accounts/{ID} | Check if price exists |
| PATCH | /pricelists2accounts/{ID} | Update existing price |

### POST /pricelists2accounts
- Summary: List pricelists-to-accounts
- OperationId: listPriceListsToAccounts
- Description: List selected data from all pricelists-to-accounts that match the specified filter and search criteria in a specific sort order. Requires `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- (none)

Request body:
- #/components/requestBodies/list

Responses:
- 200 — OK
  - application/json — array
- 401: #/components/responses/401
- 403: #/components/responses/403
- 500: #/components/responses/500

### PUT /pricelists2accounts
- Summary: Create new price
- OperationId: createPriceListToAccount
- Description: Create a new price and return its persistent data. Requires writable `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- (none)

Request body:
- #/components/requestBodies/pricelists2accounts

Responses:
- 201 — Successful Creation (Created)
  - application/json — #/components/schemas/pricelists2accounts
- 401: #/components/responses/401
- 403: #/components/responses/403
- 409 — ID Present (Conflict)
- 410 — Gone
- 500: #/components/responses/500

### DELETE /pricelists2accounts/{ID}
- Summary: Delete price
- OperationId: deletePriceListToAccount
- Description: Permanently delete an existing price by **`ID`**. Requires writable `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- #/components/parameters/ID
- #/components/parameters/If-Match
- #/components/parameters/If-Unmodified-Since

Request body:
- (none)

Responses:
- 204 — Successful Deletion (No Content)
- 401: #/components/responses/401
- 403: #/components/responses/403
- 404 — Not Found
- 409 — Not Deletable (Conflict)
- 412 — Non-matching ETag (Precondition Failed)
- 500: #/components/responses/500

### GET /pricelists2accounts/{ID}
- Summary: Get price
- OperationId: getPriceListToAccount
- Description: Return the data of an existing price by **`ID`**. Requires `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- #/components/parameters/ID
- #/components/parameters/expand
- #/components/parameters/If-Modified-Since
- #/components/parameters/If-None-Match

Request body:
- (none)

Responses:
- 200 — OK
  - application/json — #/components/schemas/pricelists2accounts
- 304 — Not Modified
- 401: #/components/responses/401
- 403: #/components/responses/403
- 404 — Not Found
- 500: #/components/responses/500

### HEAD /pricelists2accounts/{ID}
- Summary: Check if price exists
- OperationId: existsPriceListToAccount
- Description: Check if a price with **`ID`** exists, but do not return its data. Requires `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- #/components/parameters/ID
- #/components/parameters/If-Modified-Since
- #/components/parameters/If-None-Match

Request body:
- (none)

Responses:
- 204: #/components/responses/204-exists
- 304 — Not Modified
- 401: #/components/responses/401
- 404 — Not Found
- 500: #/components/responses/500

### PATCH /pricelists2accounts/{ID}
- Summary: Update existing price
- OperationId: updatePriceListToAccount
- Description: Update an existing price by **`ID`** and return its persistent data. Requires writable `pricelists` or `accounts` permission. Has dependencies on `pricelist` and `account`.

Parameters:
- #/components/parameters/ID
- #/components/parameters/If-Match
- #/components/parameters/If-Unmodified-Since

Request body:
- #/components/requestBodies/pricelists2accounts

Responses:
- 200 — Successful Update (OK)
  - application/json — #/components/schemas/pricelists2accounts
- 401: #/components/responses/401
- 403: #/components/responses/403
- 404 — Not Found
- 409 — Non-matching ID (Conflict)
- 410 — Gone
- 412 — Non-matching ETag (Precondition Failed)
- 500: #/components/responses/500