Success responses

When a request succeeds, the Bachs API returns the resource directly with a 2xx status code. Objects are returned flat, without a wrapper. List endpoints return an items array alongside a pagination object. For error responses, see Errors.

Status codes

Action	Method	Status	Body
Create a resource	`POST`	`201`	The created object, including generated fields.
Retrieve a resource	`GET`	`200`	The requested object.
List resources	`GET`	`200`	An `items` array and a `pagination` object.
Update a resource	`PATCH`	`200`	The updated object, including unchanged fields.
Delete a resource	`DELETE`	`204`	Empty. No body is returned.

Single object

A retrieve, create, or update returns the object at the top level. Read its fields directly, with no wrapper to unpack.

{
  "id": "prod_5568ed9ab9d04dd7a31d",
  "name": "Pro plan",
  "status": "active",
  "created_at": "2026-07-13T15:28:39.874Z"
}

A POST returns 201 with every field of the new object, including any the server generated (id, created_at) or filled with defaults.

List

Every list endpoint returns the same shape: an items array of objects and a pagination object. The array is always named items, never the resource name.

{
  "items": [
    {
      "id": "cust_a1b2c3d4e5f6",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "created_at": "2026-07-13T14:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "cur_20",
    "prev_cursor": null,
    "has_more": true,
    "limit": 20,
    "offset": 0,
    "returned": 1,
    "total": 47
  }
}

Each entry in items is the same object shape returned by that resource’s retrieve endpoint. See Pagination for how to page through results.

Delete

A successful DELETE returns 204 No Content with an empty body. There is nothing to parse. Treat the 204 status itself as confirmation.

Request ID

Every response, success or error, includes an x-request-id header. Log it, and include it when you contact support. See Errors for details.

General

Checkout Sessions

Connected Accounts

Products

Subscriptions

Customers

Customer sessions

Payments

Refunds

Disputes

Payouts

Payout Destinations

Balance

Virtual accounts

Your account

Media

Misc

Transfers

Persons

Platform Fees

Reference

Success responses

Status codes

Single object

List

Delete

Request ID

​Status codes

​Single object

​List

​Delete

​Request ID

Status codes

Single object

List

Delete

Request ID