Get a registration
Retrieve a single product registration by its Corso ID.
Path Parameters
- registrationId number required
The Corso ID for the registration
Example: 789012
- 200
- 400
- 401
- 403
- 404
- 429
OK
- application/json
- Schema
- Example (from schema)
Schema
- registrationId number required
The Corso ID of the registration.
- storeId number required
The Corso ID of the store that the registration belongs to.
- externalId string required
The external registration ID, used for customer-facing references.
- customerEmail string required
The email address of the customer who created the registration.
- customerName string
The name of the customer who created the registration.
- channelName string required
The name of the registration channel.
- customerProvidedOrderNumber string
The order number provided by the customer during registration, if applicable.
- estimatedPurchaseDate date-time
The estimated date of purchase provided by the customer, if applicable.
- referrer string
The referrer URL or source for this registration.
- emailMarketingConsent boolean required
Whether the customer consented to email marketing during registration.
- emailMarketingConsentCollectedOn date-time
The date/time when email marketing consent was collected, if applicable.
lineItems object[] required
The product line items associated with this registration.
Array [lineItemId number requiredThe ID of the line item in Corso systems.
sourceLineItemId string requiredThe line item ID (from the source system).
productId stringThe product ID for the line item (from the source system).
variantId stringThe variant ID for the line item (from the source system). For the line item that represents the Corso Green Shipping Product (if purchased on the order), this should match the corresponding variant ID stored by Corso in our system, so that we can identify the order as protected.
sku string requiredThe SKU of product/variant of the line item.
name string requiredThe line item name, typically the value shown to the customer representing the product/variant combination purchased.
quantity number requiredThe quantity purchased for the line item.
imgUrl stringURL of the product image, if available.
]customFields object[]
Custom field values captured during registration.
Array [name string requiredThe name of the custom field.
value string requiredThe value of the custom field.
]- proofOfPurchaseFileUrls string[]
URLs to proof-of-purchase files uploaded by the customer.
- createdOn date-time
The date/time when the registration was created.
- updatedOn date-time
The date/time when the registration was last updated.
- canceledOn date-time
The date/time when the registration was canceled, if applicable.
claims object[] required
Array [claimId number requiredThe Corso ID of the claim.
externalId string requiredThe external ID of the claim.
claimType string requiredPossible values: [
Warranty,Return]The type of the claim.
]
{
"registrationId": 789012,
"storeId": 123456,
"externalId": "REG-1-456",
"customerEmail": "[email protected]",
"customerName": "Jane Doe",
"channelName": "Online Store",
"customerProvidedOrderNumber": "#1580",
"estimatedPurchaseDate": "2024-06-15T00:00:00Z",
"referrer": "https://example.com/products/widget",
"emailMarketingConsent": true,
"emailMarketingConsentCollectedOn": "2024-01-20T14:45:00Z",
"lineItems": [
{
"lineItemId": 18372912,
"sourceLineItemId": "990986",
"productId": "pro-33320",
"variantId": "var-4569876332",
"sku": "ITEM-12345",
"name": "Shorts - color: blue, size: small",
"quantity": 1,
"imgUrl": "https://cdn.example.com/products/widget-blue.jpg"
}
],
"customFields": [
{
"name": "Serial Number",
"value": "SN-12345-AB"
}
],
"proofOfPurchaseFileUrls": [
"https://cdn.example.com/registrations/receipt1.jpg",
"https://cdn.example.com/registrations/receipt2.jpg"
],
"createdOn": "2024-01-20T14:45:00Z",
"updatedOn": "2024-01-21T09:15:00Z",
"canceledOn": "2024-02-01T10:00:00Z",
"claims": [
{
"claimId": 123456,
"externalId": "1-123-1",
"claimType": "Warranty"
}
]
}
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Response Headers
RateLimit-Limit integer
The maximum number of requests allowed in the current window.
RateLimit-Remaining integer
The number of requests remaining in the current window.
RateLimit-Reset integer
The number of seconds until the current rate limit window resets.
Retry-After integer
The number of seconds to wait before retrying (only present when rate limited).