Welcome to Marktplaats API’s documentation!

Contents:

• Overview
  • Multi tenant/multi locale
  • Accept Headers
  • Authentication
  • Dates and Times
  • Prices and Currencies
  • HTTP Response Codes and Error Handling
  • Field definitions
  • HTTP PATCH Methods
    • Errors
• Authentication
  • What is OAuth 2.0?
  • OAuth 2.0 Roles
  • OAuth 2.0 Endpoints
  • Obtaining an Access Token for a user
    • Step 1: Redirect to the authorization URL
    • Step 2: Redirect to the redirect_uri
    • Step 3: POST to the token endpoint
    • Step 4: Receive token response
  • Refreshing an Access Token
  • Obtaining an Access Token for a client
    • Step 1: POST to the token endpoint
    • Step 2: Receive token response
  • Authorization using access_token
  • Expiration Times
• Webhooks
  • Message Delivery Guarantees
  • Validating the authenticity of requests
  • Generic Message format
  • BidPlacedEvent
  • BidClosedEvent
  • AsqCreatedEvent
  • transactionStatusChanged
  • CallNotificationEvent
  • Examples
• Root
  • Relations
  • Example
• Categories
  • Fields
  • Relations
  • Reference
  • Errors
  • Example
• Category attributes
  • Reference
  • Example
• Category fees
  • Reference
  • Example
• Advertisements
  • Relations
  • Reference
  • Examples
• Advertisement
  • Automotive advertisements
  • Fields
  • Attributes (Optional fields)
  • Relations
  • Reference
  • Errors
  • Field errors
  • Examples
  • Updating an advertisement
    • Example
• Advertisement images
  • Reference
  • Examples
• Advertisement features
  • Reference
  • Examples
• Advertisement feature
  • Fields
  • Relations
  • Reference
  • Errors
• Advertisement purchased feature
  • Fields
  • Reference
  • Examples
• Advertisement fitments
  • Reference
• Advertisement renewal
  • Reference
  • Example
  • Errors
• Advertisement statistics
  • Fields
  • Reference
  • Examples
• Advertisement transaction
  • Fields
  • Reference
  • Errors
  • Examples
  • Notification
• Advertisement transactions
  • Reference
  • Errors
  • Examples
• Buy advertisement feature
  • Reference
  • Example
  • Errors
• Upcall confirmations
  • Fields
  • Reference
  • Example
  • Errors
• Bids
  • Relations
  • Reference
  • Examples
• Bid
  • Fields
  • Relations
  • Reference
  • Errors
  • Examples
• Ask Bidder Question
  • Reference
  • Example
  • Errors
• Me
  • Reference
  • Examples
• Users
  • Creating user accounts
    • Relations
    • Reference
    • Examples
• User
  • Fields
  • Relations
  • Reference
  • Errors
  • Field errors
  • Examples
  • Updating a User
    • Field errors
• Change email
  • Fields
  • Reference
  • Errors
  • Field errors
  • Examples
• User advertisements
  • Query Parameters
  • Relations
  • Reference
  • Errors
  • Examples
• User brands
  • Fields
  • Reference
  • Errors
  • Examples
• User profile
  • Fields
  • Relations
  • Reference
  • Errors
  • Field errors
  • Examples
• User reviews
  • Fields
  • Reference
  • Examples
• User statistics
  • Fields
  • Reference
  • Examples
• Backdrop image
  • Reference
  • Errors
  • Field errors
  • Examples
• Profile image
  • Reference
  • Errors
  • Field errors
  • Examples
• Image
  • Fields
  • Relations
  • Reference
  • Examples
• Image blob
  • Reference
  • Examples
• Image meta information
  • Fields
  • Reference
  • Examples
• Order
  • Fields
  • Relations
  • Reference
  • Example
• Order products
  • Reference
• Order product
  • Fields
  • Reference
• Location
  • Reference
  • Errors
  • Examples
• Search
  • Query Parameters
  • Fields
  • Search request fields
  • Relations
  • Reference
  • Errors
  • Examples
• Error codes
  • API Errors
  • Field Errors
• Endpoints
• Indices and tables
• Changelog
  • 1.0
    • New Features
    • Fixes
    • Other Changes