ConnectCloud Developers

List offers in the snapshot shape (tenant:trade:sales:read)

GET /api/trade/v1/offers

Module: Trade · operationId: listIssuedOffers · Tag: Issued documents · Auth: access token (Authorization: Bearer <accessToken>)

The newest 100 transactions of type OFFER.

Responses

  • 200 Offers (application/json)
  • 401 No valid session or bearer token (no body).

Fields of the 200 answer:

  • items (array of IssuedOffer, required)
    • addressId (string): Masterdata address of the customer.
    • addressSnapshot (AddressSnapshot): Frozen copy of the partner address (GoBD).
    • articleSnapshots (array of object): Lines as sent. Recognised keys: articleNumber, name, description, quantity (default 1), unit, unitPriceNet (or price), discountPercent, taxRate; the entry is kept as sent.
    • createdAt (string (date-time)): When the offer was created.
    • customerNo (string): Customer number of the tenant.
    • id (string (uuid)): Id of the offer.
    • offerNumber (string): Number of the offer.
    • status (string): Status of the offer.
    • tenantName (string): Name of the tenant.
    • totalAmount (number): Total of the offer.

Example 200 answer:

{
  "items": [
    {
      "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05",
      "addressSnapshot": {
        "city": "Neutraubling",
        "companyName": "Donau Maschinenbau AG",
        "country": "DE",
        "street": "Werkstraße 100",
        "zip": "93073"
      },
      "articleSnapshots": [
        {
          "articleNumber": "HW-1002",
          "name": "Notebook EliteBook 860 G11, i7, 32 GB, 1 TB SSD",
          "quantity": 4,
          "taxRate": 19,
          "unitPriceNet": 1699
        },
        {
          "articleNumber": "HW-1004",
          "name": "USB-C Dockingstation 100 W",
          "quantity": 4,
          "taxRate": 19,
          "unitPriceNet": 189
        }
      ],
      "createdAt": "2026-11-18T14:05:00Z",
      "customerNo": "99999",
      "id": "6d9e0f1a-2b3c-4d4e-8f5a-7b8c9d0e1f02",
      "offerNumber": "AN-2026-0188",
      "status": "open",
      "tenantName": "DEMO",
      "totalAmount": 7552
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/trade/v1/offers' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI