Pine LabsDOCS

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.

Requires Bearer token. Get token →

Path Parameters

NameTypeDescription
order_id
stringrequired

Unique Pine Labs order identifier.

Request Body

NameTypeDescription
merchant_product_imei_reference
stringrequired

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
stringrequired

IMEI request type.

Allowed values:
BLOCKINGUNBLOCKED
products
IMEIProduct[]required

Array of product details for IMEI validation.

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.

Response

NameTypeDescription
merchant_product_imei_reference
string

Merchant product IMEI reference.

request_type
string

IMEI request type.

products
object[]

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

Product brand response details.

Status Codes

200Multi-Status — IMEI validation results per product.
207Multi-Status — IMEI validation result if validation is successful for all products.
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' \
  --data '{
  "merchant_product_imei_reference": "merchant-ref-786",
  "request_type": "BLOCKING",
  "products": [
    {
      "product_code": "xyz",
      "dealer_code": "DLR100",
      "state_code": "NY",
      "product_imei": "SN1234567863"
    }
  ]
}'

Run this request

order_id
200 OK
{
  "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"
    }
  ]
}