Skip to main content

Delete Offers

Delete offers individually or in batch.

Delete Single Offer​

Delete a specific offer by ID.

Endpoint​

DELETE /v1/offers/{id}

Path Parameters​

ParameterTypeRequiredDescription
idstringYesOffer ID (UUID)

Request Example​

curl -X DELETE "https://sellerapi.ggchest.com/v1/offers/cc0e8400-e29b-41d4-a716-446655440030" \
  -H "X-API-KEY: your-api-key-here"

Response​

Returns 200 OK on success with no response body.

Batch Delete Offers​

Delete multiple offers at once.

Endpoint​

DELETE /v1/offers

Request Body​

FieldTypeRequiredDescription
offers_idsarrayYesArray of offer UUIDs to delete

Request Example​

curl -X DELETE "https://sellerapi.ggchest.com/v1/offers" \
  -H "X-API-KEY: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "offers_ids": [
      "cc0e8400-e29b-41d4-a716-446655440030",
      "cc0e8400-e29b-41d4-a716-446655440040",
      "cc0e8400-e29b-41d4-a716-446655440050"
    ]
  }'

Response​

Returns 200 OK on success with no response body.

Error Responses​

400 Bad Request​

Returned when the request is invalid (e.g., empty offers_ids array).

{
  "message": "Bad request",
  "errors": [
    {
      "property": "offers_ids",
      "message": "At least one offer ID is required"
    }
  ]
}

403 Forbidden​

Returned when you don't have permission to delete the offer(s).

{
  "message": "Forbidden"
}

404 Not Found​

Returned when the offer ID is invalid or the offer doesn't exist (for single delete).

{
  "message": "Page not found"
}

Notes​

  • Batch delete operations are more efficient than deleting offers one by one
  • All offer IDs in the batch delete request must be valid UUIDs