Skip to content Kleinanzeigen Public API Gateway Documentation
Kleinanzeigen Logo KA Api Documentation
POST
/v1/listings/{uuid}/media
 
curl --request POST \
  --url https://developer.kleinanzeigen.de/api/goods/v1/listings/123e4567-e89b-12d3-a456-426614174000/media \
  --header 'Content-Type: application/json' \
  --header 'HttpHeaders.AUTHORIZATION: eyJhbGciOiJIUzI1NiIsInR5...' \
  --data '{ "ticketUuid": "example" }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
uuid
required
string
Example 
123e4567-e89b-12d3-a456-426614174000

Header Parameters

Section titled “Header Parameters ”
HttpHeaders.AUTHORIZATION
required

Request Body required

Section titled “Request Body required ”
Media type application/json
object
ticketUuid
required
string
Example generated
{
  "ticketUuid": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successfully added the media

Media type application/json
object
uuid
required
string
category
required
string
title
required
string
description
required
string
attributes
required
object
key
additional properties
string
adType
required
string
adPrice
required
object
type
required
string
amount
required
number format: double
userId
required
string
email
required
string
phoneNumber
string | null
customReference
string | null
contactPerson
string | null
buyNow
boolean | null
urls
required
Array<string>
Example 
{
  "uuid": "dfe2ec14-56ec-40a1-9837-d777d850347b",
  "urls": [
    "a4/a43fb81e-8d11-4eb3-aac8-ce5bf75a446b"
  ]
}

404

Section titled “404 ”

Ticket not found or expired

Media type 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": "Ticket not found/expired.",
  "instance": "/api/v1/listings/123e4567-e89b-12d3-a456-426614174000/media",
  "localizedTitle": "",
  "localizedDetail": "",
  "localizedMessage": ""
}

413

Section titled “413 ”

Media is too large

Media type 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": 413,
  "title": "PAYLOAD_TOO_LARGE",
  "detail": "Media is too large.",
  "instance": "/api/v1/listings/123e4567-e89b-12d3-a456-426614174000/media",
  "localizedTitle": "",
  "localizedDetail": "",
  "localizedMessage": ""
}