1. Data PINs
Dailybest Developer API
  • Auth
    • Check your credentials
      GET
  • Data
    • Buy data
      POST
    • List data plans
      GET
    • Check a data purchase
      GET
  • Wallet
    • Get wallet balance
      GET
  • Airtime
    • Buy airtime
      POST
    • List airtime networks
      GET
    • Check an airtime purchase
      GET
  • Electricity
    • Pay for electricity
      POST
    • Check an electricity payment
      GET
    • List distribution companies
      GET
    • Verify a meter
      POST
  • Cable TV
    • Renew a TV subscription
    • List TV operators
    • Check a TV subscription
    • List TV packages
    • Verify a smartcard
  • Data PINs
    • Generate a batch of data PINs
      POST
    • List your PIN batches
      GET
    • List data PIN plans
      GET
    • Your PIN generation limits
      GET
    • Approve a PIN batch
      POST
    • Get a PIN batch
      GET
    • Reject a PIN batch
      POST
    • Disable a PIN batch
      POST
    • List a batch's PINs
      GET
    • Look up a PIN
      GET
    • Disable one PIN
      POST
    • Simulate a dial
      POST
    • Get print layout customization
      GET
    • Print a batch (data and layout)
      GET
  • Virtual cards
    • Issue a virtual card
  • Transactions
    • List transactions
    • Get a transaction
    • Resend a transaction webhook
  • Webhooks
    • List supported webhook events
    • Send a sample webhook
  • Schemas
    • PurchaseDataDto
    • PurchaseAirtimeDto
    • VerifyMeterDto
    • PurchaseElectricityDto
    • VerifyTvCustomerDto
    • IssueVirtualCardDto
    • PurchaseTvDto
    • TransactionType
    • GenerateBatchDto
    • TransactionStatus
    • BatchReasonDto
    • TransactionChannel
    • SimulateDialDto
    • Network
    • MeterType
    • TvOperator
    • SendSampleWebhookDto
  1. Data PINs

Get a PIN batch

GET
/v1/datapin/b2b/batches/{uuid}
One of your batches.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Responses

🟢200
application/json
Success
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://localhost:5050/v1/datapin/b2b/batches/' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "uuid": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
        "label": "Ikeja shop — March",
        "status": "PENDING_APPROVAL",
        "network": "MTN",
        "plan": {
            "planId": "MTN-1GB-30D",
            "name": "1GB · 30 days"
        },
        "quantity": 2,
        "pins": {
            "active": 2,
            "used": 0,
            "disabled": 0,
            "refunded": 0
        },
        "approvedVia": null,
        "approvedAt": null,
        "createdAt": "2026-10-06T09:15:00.000Z"
    }
}
Modified at 2026-10-07 12:05:01
Previous
Approve a PIN batch
Next
Reject a PIN batch
Built with