GetListing

GET

/v1/listings/{uuid}

const url = 'https://developer.kleinanzeigen.de/api/goods/v1/listings/123e4567-e89b-12d3-a456-426614174000';
const options = {
  method: 'GET',
  headers: {'HttpHeaders.AUTHORIZATION': 'eyJhbGciOiJIUzI1NiIsInR5...'}
};

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://developer.kleinanzeigen.de/api/goods/v1/listings/123e4567-e89b-12d3-a456-426614174000 \
  --header 'HttpHeaders.AUTHORIZATION: eyJhbGciOiJIUzI1NiIsInR5...'

Retrieves a specific listing by its UUID. The listing must belong to the authenticated user.

Parameters

Path Parameters

uuid

required

string

Example

123e4567-e89b-12d3-a456-426614174000

Header Parameters

HttpHeaders.AUTHORIZATION

required

Responses

200

Successfully returned listing details for the specified uuid

application/json

string

Example

{
  "uuid": "dfe2ec14-56ec-40a1-9837-d777d850347b",
  "category": "Spielzeug",
  "title": "My Listing",
  "description": "Description of my listing",
  "attributes": {
    "art": "actionfiguren",
    "condition": "like_new",
    "versand": "ja"
  },
  "adType": "OFFER",
  "adPrice": {
    "type": "FIXED",
    "amount": 100
  },
  "userId": "11111111-k6gd-4113-b395-5459ec678ddd",
  "email": "john@abc.com",
  "phoneNumber": "123456789",
  "customReference": "4345339",
  "contactPerson": "John Doe",
  "buyNow": false,
  "urls": []
}

404

Couldn’t find a listing for the specified UUID

application/json

object

type

string format: uri

title

string | null

status

integer format: int32

detail

string | null

instance

string | null format: uri

properties

object | null

Example

{
  "type": "about:blank",
  "status": 404,
  "title": "Not Found",
  "detail": "Listing not found",
  "instance": "/api/v1/listings/123e4567-e89b-12d3-a456-426614174000",
  "localizedTitle": "",
  "localizedDetail": "",
  "localizedMessage": ""
}