List the documents of a listing

GET

/listings/{listingId}/attachments

const url = 'https://acme.mykreezalid.com/front_api/v1/listings/4242/attachments?page=1&limit=25';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://acme.mykreezalid.com/front_api/v1/listings/4242/attachments?page=1&limit=25' \
  --header 'Authorization: Bearer <token>'

Returns the documents attached to a listing, 25 per page. The response carries no paging information.

Authorizations

bearerAuth

Parameters

Path Parameters

listingId

required

integer

Listing ID.

Example

Query Parameters

page

integer

default: 1 >= 1

Page to return, starting at 1.

limit

integer

default: 25 >= 1 <= 100

Number of documents per page (at most 100).

Responses

200

The documents.

application/json

object

attachments

Array<object>

A document attached to a listing, such as a user manual or a warranty.

object

integer

app_id

Identifier of your marketplace. Returned by the list and get operations only.

integer

listing_id

Listing the document belongs to.

integer

createdBy

Member who added the document.

integer

nullable

updatedBy

Member who last changed the document. Returned by the list and get operations only.

integer

nullable

name

Display name of the document.

string

nullable

type

string

Allowed values: USER_MANUAL WARRANTY CERTIFICATES OTHER MEASURE_INSTRUCTIONS

url

Public URL of the stored file.

string format: uri

filename

File name of the stored file.

string

nullable

created

string format: date-time

modified

string format: date-time

Example

{
  "attachments": [
    {
      "id": 310,
      "app_id": 1001,
      "listing_id": 4242,
      "createdBy": 8128,
      "name": "User manual",
      "type": "USER_MANUAL",
      "url": "https://cdn.example.com/assets/manual.pdf",
      "filename": "manual.pdf",
      "created": "2026-10-13T09:30:00+00:00",
      "modified": "2026-10-13T09:30:00+00:00"
    }
  ]
}

403

No valid access token was sent.

application/json

Error body returned by the Front API when it refuses a request.

object

code

HTTP status code, repeated in the body.

integer

status

string

message

Human-readable reason.

string

Example

{
  "code": 403,
  "status": "error",
  "message": "Token not found in request"
}