markaDocs

List your listings

GET
/v1/listings
x-api-key<token>

API key created in your Marka account settings, sent as an x-api-key header (an Authorization: Bearer mk_… header is accepted as an equivalent spelling). Key-authenticated writes additionally require the api_write entitlement, which the Pro plan and above carry. A signed-in browser session cookie is also accepted for interactive exploration from the Marka web app; SDK and server-to-server clients always use a key.

In: header

Query Parameters

limit?integer

Page size, 1-100. Defaults to 50.

Range1 <= value <= 100
offset?integer

Number of records to skip. Defaults to 0.

Range0 <= value <= 9007199254740991

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/listings"
{  "hasMore": true,  "limit": 1,  "listings": [    {      "acceptsOffers": true,      "attributes": "string",      "authority": "MARKA",      "autoAcceptOfferAmount": 0,      "brand": "string",      "categoryPath": "string",      "checkoutEnabled": true,      "condition": "new",      "createdAt": "2019-08-24T14:15:22Z",      "currency": "string",      "description": "string",      "directEnabled": true,      "gtin": "string",      "id": "string",      "imageUrls": [        "string"      ],      "inventoryType": "unique",      "location": {        "addressLine1": "string",        "addressLine2": "string",        "city": "string",        "country": "string",        "latitude": -90,        "longitude": -180,        "postalCode": "string",        "region": "string"      },      "madeInCountry": "string",      "packageDimensionsMm": {        "heightMm": 0,        "lengthMm": 0,        "widthMm": 0      },      "packageWeightGrams": 0,      "pickupEnabled": true,      "price": 0,      "quantityReserved": 0,      "quantityTotal": 0,      "riskCategory": "general",      "sellerAccountId": "string",      "shippingEnabled": true,      "shippingFlatAmount": 0,      "shippingProfileId": "string",      "status": "draft",      "title": "string",      "updatedAt": "2019-08-24T14:15:22Z",      "visibilityRadiusKm": 1    }  ],  "offset": 0}