Create IMEI Validation

POST/api/affordability/v1/product/{order_id}/imei

Validate or block/unblock IMEI numbers for Brand EMI transactions. Used to confirm the device is eligible for the selected EMI program.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Field	Details
`order_id` `string`required	Unique Pine Labs order identifier.

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

Field	Details
`merchant_product_imei_reference` `string`required	Idempotency Key. Merchant product IMEI reference. Duplicate requests with the same `merchant_product_imei_reference` will return the existing result instead of creating a new one.
`request_type` `string`required	IMEI request type. Allowed values: `BLOCKINGUNBLOCKED`
`products` `IMEIProduct[]`required4 nested fields	Array of product details for IMEI validation.

Response

Field	Details
`merchant_product_imei_reference` `string`	Merchant product IMEI reference.
`request_type` `string`	IMEI request type.
`products` `object[]`6 nested fields	Array of validated product results.
`product_code` `string`	Unique product identifier.
`dealer_code` `string`	Unique identifier for the dealer.
`state_code` `string`	State code.
`product_imei` `string`	The unique IMEI number of the product.
`product_imei_status` `string`	Product IMEI status. Allowed values: `BLOCKEDUNBLOCKED`
`product_brand_response` `object`2 nested fields	Product brand response details.

Status Codes

`200`	Multi-Status — IMEI validation results per product.
`207`	Multi-Status — IMEI validation result if validation is successful for all products.

Run

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/affordability/v1/product/v1-5757575757-aa-hU1rUd/imei \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data '{
  "merchant_product_imei_reference": "merchant-ref-786",
  "request_type": "BLOCKING",
  "products": [
    {
      "product_code": "xyz",
      "dealer_code": "DLR100",
      "state_code": "NY",
      "product_imei": "SN1234567863"
    }
  ]
}'

Status:

{
  "merchant_product_imei_reference": "merchant-ref-786",
  "request_type": "BLOCKING",
  "products": [
    {
      "product_code": "xyz",
      "dealer_code": "DLR100",
      "state_code": "NY",
      "product_imei": "SN1234567863",
      "product_imei_status": "BLOCKED"
    }
  ]
}