---
title: "Get payments feed"
method: GET
path: "/v2/lookup"
tags: ["Feed"]
---

# Get payments feed

`GET /v2/lookup`

## Request

- Base URL: `https://feed.centrobill.com`
- URL: `https://feed.centrobill.com/v2/lookup`
- Auth: API key in header `Authorization`

Get payments feed

## Query parameters

- `dateFrom` string
- `dateTo` string
- `limit` integer
- `page` integer
- `orderId` string
- `transactionId` string
- `lastTransactionId` string
- `ustas` string
- `systemId` string
- `uuid` string
- `lastUuid` string
- `siteName` string
- `fields` string
- `ignored` string
- `status` string[]
- `mode` string[]
- `cardLast4Digits` string
- `externalTransactionId` string
- `gatewayAmount` number
- `gatewayCurrency` string
- `gatewayPricePercentDiff` number
- `loadAll` boolean
- `paymentType` string
- `prevTransactionId` string
- `cardBin` string

## Response `200`

Lookup body

- object
  - `data` object[]
    - `payment` object
      - `uuid` string
      - `code` '0' | '5001' | '5003' | '5004' | '5005' | '5006' | '5007' | '5010' | '5012' | '5013' | '5014' | '5015' | '5019' | '5030' | '5041' | '5043' | '5046' | '5051' | '5054' | '5055' | '5057' | '5058' | '5059' | '5061' | '5062' | '5063' | '5065' | '5070' | '5075' | '5078' | '5080' | '5082' | '5085' | '5086' | '5091' | '5093' | '5096' | '5097' | '5220' | '5221' | '5223' | '5224': | code | description |---|---| | 0 | success | | 5001 | Refer to Issuer | | 5003 | Invalid merchant | | 5004 | Pick up card(no fraud) | | 5005 | Do not honor | | 5006 | Payment could not be authorised | | 5007 | Pick up card, special condition (fraud account) | | 5010 | Partial approval | | 5012 | Invalid transaction | | 5013 | Invalid Amount | | 5014 | Invalid Card Number | | 5015 | No such issuer | | 5019 | Re enter | | 5030 | Format error | | 5041 | Lost card, Pick up (fraud account) | | 5043 | Stolen card, pick up (fraud account) | | 5046 | Closed account | | 5051 | Insufficient Funds | | 5054 | Expired Card | | 5055 | Invalid PIN | | 5057 | Transaction not permitted - Card | | 5058 | Transaction not permitted - Terminal | | 5059 | Suspected fraud | | 5061 | Exceeds withdrawal amount limit(s) / Withdrawal amount limit exceeded | | 5062 | Invalid service code, restricted | | 5063 | Security Violation | | 5065 | Activity Limit Exceeded | | 5070 | PIN data required | | 5075 | Allowable number of PIN tries exceeded | | 5078 | Invalid/nonexistent account specified (general) | | 5080 | Credit issuer unavailable | | 5082 | Negative online CAM, dCVV, iCVV, CVV, or CAVV results or Offline PIN authentication interrupted | | 5085 | No reason to decline | | 5086 | Cannot verify PIN | | 5091 | Issuer or switch is unavailable | | 5093 | Violation, cannot complete | | 5096 | System error | | 5099 | Expired payment | | 5220 | Authentication Failed by Card Issuer | | 5221 | Authentication is Unavailable at the current time | | 5223 | Rejected authentication by the issuer | | 5224 | Card not enrolled |
      - `description` string
      - `action` 'redirect' | 'charge' | 'credit' | 'chargeback': | action name | description | |---|---| | charge | Card will be charged immediately. | | redirect | Consumer should be redirected to url for second step |
      - `url` string, url: URL
      - `mode` 'sale' | 'auth' | 'settle' | 'refund' | 'void' | 'chargebackFirst' | 'chargebackSecond' | 'chargebackRepresent' | 'chargebackRetrieval' | 'chargebackCollector'
      - `status` 'success' | 'fail' | 'pending'
      - `amount` number, double
      - `currency` string, iso3
      - `orderId` string
      - `transactionId` string
      - `parentTransactionId` string
      - `descriptor` string
      - `source` object
        - `method` 'card' | 'applepay' | 'sepa' | 'sofortbanking' | 'ideal' | 'eps' | 'mybank' | 'bancontact' | 'giropay' | 'przelewy24' | 'onlinebanking' | 'skrill' | 'clickandbuy' | 'paypal' | 'crypto' | 'paygarden' | 'alipay' | 'wechat' | 'unionpay' | 'voucher' | 'paysafecard' | 'ukash' | 'safeklick' | 'sms'
        - `number` string
        - `brand` string
        - `paymentAccountId` string, uuid
    - `consumer` object
      - `id` string
      - `email` string, email
      - `firstName` string
      - `lastName` string
      - `phone` string
      - `country` string, iso3
      - `state` string
      - `city` string
      - `zip` string
    - `subscription` object
      - `id` string
      - `status` 'active' | 'canceled', nullable
      - `renewalDate` string, date-time, nullable
      - `cancelDate` string, date-time, nullable
      - `cycle` number, nullable: | value | description | |---|---| | 0 | subscription has an initial payment | | n | subscription has n recurrent payments |
    - `metadata` object: Used for storing additional structured information associated with payment
  - `meta` object
    - `currentPage` integer
    - `lastPage` integer
    - `perPage` integer
    - `total` integer
    - `links` object[]
      - `link` object
        - `rel` string
        - `href` string

## Other responses

- `401`: JSON error object
- `403`: JSON error object
- `422`: JSON error object
- `500`: JSON error object

---

[API](https://skmtc.dev/centrobill/apis/centrobill-feed.md) - [All operations](https://skmtc.dev/centrobill/apis/centrobill-feed/llms.txt) - [OpenAPI document](https://skmtc.dev/centrobill/apis/centrobill-feed/revisions/fd11f3f5539c?raw)