OTotto
SponsoredProductAds V1

Get change request

Changed on

Retrieve the current status and details of a change request. Use this endpoint to check whether a previously submitted write operation was accepted or rejected, and to obtain the rejection reason if applicable.

Common rejection reasons:

  • "The specified SKU does not exist in the product catalog." — SKU provided in a target creation was not found in OTTO's product catalog.
  • "Negative keywords are not supported for MANUAL campaigns." — illustrative rejection reason when keyword creation includes a negative keyword for a MANUAL campaign.
  • "The partner account is blocked and cannot create or modify campaigns." — the partner has been blocked; no write operations will be processed until the block is lifted.
  • "An internal error occurred while processing the request. Please retry." — transient internal failure; the entity was not modified and the request can be safely retried.
get/v1/sponsored-product-ads/change-requests/{requestId}

Request

  • Base URL
    https://api.otto.market
  • URL
    https://api.otto.market/v1/sponsored-product-ads/change-requests/{requestId}
  • Auth
    HTTP bearer

Path parameters

requestIdstring uuid required
Example:00000004-0000-4000-8000-000000000004

Unique change request identifier.

Response

Change request details retrieved successfully.

requestIdstring uuid required
requestType'CREATE_CAMPAIGN' | 'UPDATE_CAMPAIGN' | 'CREATE_TARGETS' | 'UPDATE_TARGETS' | 'DELETE_TARGETS' | 'CREATE_KEYWORDS' | 'UPDATE_KEYWORDS' | 'DELETE_KEYWORDS' required
status'PENDING' | 'ACCEPTED' | 'REJECTED' required
lastModifiedAtstring date-time required

Timestamp of the last status change of this change request.

rejectionReasonstring nullable

Human-readable explanation of why the request was rejected. Only present when status is REJECTED. See the getChangeRequest operation description for a list of common rejection reasons.

entityIdsstring[] nullable

IDs of the entities affected by this request. null for CREATE operations while still PENDING (entities not yet assigned). Populated with entity IDs once the request is ACCEPTED.

Example response

{
  "requestId": "00000004-0000-4000-8000-000000000004",
  "requestType": "CREATE_TARGETS",
  "status": "REJECTED",
  "lastModifiedAt": "2026-04-14T10:00:00Z",
  "rejectionReason": "The specified SKU does not exist in the product catalog.",
  "entityIds": [],
  "_links": {
    "self": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/change-requests/00000004-0000-4000-8000-000000000004"
    }
  }
}

Changes