Skip to main content
POST
/
api
/
v1
/
pos
/
lookup-card
curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/pos/lookup-card" \
  -H "Authorization: Bearer olive_live_xxx" \
  -d '{ "card_identifier": "OLIV0001" }'

{
  "found": true,
  "card": {
    "serial": "OLIV0001",
    "status": "ACTIVE",
    "type": "PARENT"
  },
  "subscriber": {
    "id": "sub_abc123",
    "name": "John Doe",
    "phone": "+23277123456"
  }
}
Administrative endpoint to resolve a card serial or MAC address to a subscriber.

​
Request

​
Authorization
string
required
Bearer olive_live_xxx

​
Body Parameters

​
card_identifier
string
required
Card Serial OR MAC Address

​
Response

​
found
boolean
Whether card exists
​
card
object
Card details
​
subscriber
object
Subscriber details

​
Examples

curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/pos/lookup-card" \
  -H "Authorization: Bearer olive_live_xxx" \
  -d '{ "card_identifier": "OLIV0001" }'

{
  "found": true,
  "card": {
    "serial": "OLIV0001",
    "status": "ACTIVE",
    "type": "PARENT"
  },
  "subscriber": {
    "id": "sub_abc123",
    "name": "John Doe",
    "phone": "+23277123456"
  }
}

​
Uses

Support

Help customers find lost card details

Diagnostics

Check if MAC address matches serial