> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useglyde.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartcard Enquiry

> Validate a cable TV smartcard/IUC number and resolve its customer name. Confirm the name with your customer before buying a subscription, and send it back as `customer_name` on the purchase.



## OpenAPI

````yaml get /v1/bills/smartcard-enquiry
openapi: 3.0.3
info:
  title: Glyde Public API
  description: Glyde API for payments, collections, transfers, and virtual accounts
  version: 1.0.0
servers:
  - url: https://api.useglyde.co
    description: Production
  - url: https://sandbox.useglyde.co
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Account verification and bank listing
  - name: Collection
    description: Accept payments from customers
  - name: Transfers
    description: Send money to bank accounts. Available in NGN and ZAR
  - name: Transactions
    description: Transaction history and details
  - name: Settlements
    description: Settlement management
  - name: Wallet
    description: Per-currency wallet balances
  - name: Verification
    description: Identity verification
  - name: Virtual Accounts
    description: Virtual account management
  - name: Bills
    description: Buy airtime, data, electricity and cable TV from your naira wallet
paths:
  /v1/bills/smartcard-enquiry:
    get:
      tags:
        - Bills
      summary: Smartcard Enquiry
      description: >-
        Validate a cable TV smartcard/IUC number and resolve its customer name.
        Confirm the name with your customer before buying a subscription, and
        send it back as `customer_name` on the purchase.
      operationId: billsSmartcardEnquiry
      parameters:
        - name: service_code
          in: query
          required: true
          schema:
            type: string
          description: A cable biller's service code from List Billers (`category=cable`)
          example: dstv
        - name: smartcard_number
          in: query
          required: true
          schema:
            type: string
          description: The customer's smartcard or IUC number
          example: '1234567890'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  message:
                    type: string
                    example: Smartcard validated
                  data:
                    type: object
                    properties:
                      smartcard_number:
                        type: string
                        example: '1234567890'
                      customer_name:
                        type: string
                        example: John Doe
                      current_bouquet:
                        type: string
                        nullable: true
                        example: Compact
        '422':
          description: Validation error, or the smartcard number could not be validated
        '503':
          $ref: '#/components/responses/BillsUnavailable'
components:
  responses:
    BillsUnavailable:
      description: >-
        Bill payments are switched off for your business, or the biller could
        not be reached. Try again shortly.
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: >-
                  Bill payments are temporarily unavailable. Please try again
                  shortly.
              errors:
                type: object
                nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.