---
updatedAt: 2026-09-08T22:12:17.000Z
agentTools:
  projectIndex: https://developers.virtualincentives.com/llms.txt
---

# Get Card by Barcode

**Endpoint:** `https://rest.virtualincentives.com/{version}/{format}/instant/cards/barcode/{barcode}`

**Method:** `GET`

# Definitions

| Field       | Type                               | Description                                                                           |
| ----------- | ---------------------------------- | ------------------------------------------------------------------------------------- |
| barcode     | **response only**<br /> integer    | The unique id assigned to the card carrier’s barcode.                                 |
| recipientid | **response only**<br /> integer    | The unique id for this recipient.                                                     |
| balance     | **response only**<br /> decimal    | Remaining card balance                                                                |
| state       | **response only**<br /> string(50) | Current state of the card after activation request: Active, Suspended, or Terminated. |

# Examples

## Response XML

```text
<card>
   <barcode>5789654132687</barcode>
   <recipientid>2654789</recipientid>
   <balance>1.00</balance>
   <state>ACTIVE</state>
</card>
```

## Response JSON

```text
{
  "card": {
    "barcode": "5789654132687",
    "recipientid" : "2654789",
    "balance": 1.00,
    "state": "ACTIVE"
  }
}
```