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

# List

> Returns all current bank, fuel, toll, and combined fuel-toll cards. The optional `type` filter accepts one or more comma-separated card types.



## OpenAPI

````yaml https://logistics.api.smartcp.org/openapi/fleet-cards.openapi.json GET /fleet/cards
openapi: 3.0.3
info:
  title: SmartCP Logistics Fleet Cards API
  version: 1.0.0
  description: Fleet card listing endpoint for the SmartCP Logistics public REST API.
servers:
  - url: https://logistics.api.smartcp.org/v1
    description: Production
security:
  - bearerAuth: []
    directoryHeader: []
paths:
  /fleet/cards:
    get:
      summary: List
      description: >-
        Returns all current bank, fuel, toll, and combined fuel-toll cards. The
        optional `type` filter accepts one or more comma-separated card types.
      operationId: listFleetCards
      parameters:
        - name: type
          in: query
          description: One or more comma-separated card types.
          example: bank,fuel
          schema:
            type: string
      responses:
        '200':
          description: Fleet cards returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FleetCardsResponse'
              example:
                status: 200
                message: OK
                data:
                  - type: bank
                    card_number: '5577889900114821'
                    account_number: PL00123456789012345678901234
                    expiration_date: '2028-09-30'
                    provider: ING
                    vehicle:
                      nr: DW 1234A
                      name: Mercedes Actros 01
        '401':
          $ref: '#/components/responses/UnauthorizedResponse'
        '422':
          $ref: '#/components/responses/ValidationErrorResponse'
        '429':
          $ref: '#/components/responses/TooManyRequestsResponse'
        '500':
          $ref: '#/components/responses/InternalServerErrorResponse'
components:
  schemas:
    FleetCardsResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: integer
          example: 200
        message:
          type: string
          example: OK
        data:
          type: array
          items:
            $ref: '#/components/schemas/FleetCard'
    FleetCard:
      type: object
      required:
        - type
        - card_number
        - account_number
        - expiration_date
        - provider
        - vehicle
      properties:
        type:
          type: string
          nullable: true
          enum:
            - fuel
            - toll
            - fuel-toll
            - bank
        card_number:
          type: string
          nullable: true
          description: Full card number.
        account_number:
          type: string
          nullable: true
          description: Bank account number for bank cards; `null` for other card types.
        expiration_date:
          type: string
          format: date
          nullable: true
          description: Card expiration date in `YYYY-MM-DD` format.
        provider:
          type: string
          nullable: true
          description: Card provider name.
        vehicle:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/Vehicle'
    StringErrorResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: integer
          example: 422
        message:
          type: string
          example: The selected card type is invalid.
        data:
          nullable: true
          example: null
    Vehicle:
      type: object
      required:
        - nr
        - name
      properties:
        nr:
          type: string
          nullable: true
          description: Vehicle registration number.
        name:
          type: string
          nullable: true
          description: Vehicle name.
  responses:
    UnauthorizedResponse:
      description: Authentication failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StringErrorResponse'
          example:
            status: 401
            message: Authentication failed
            data: null
    ValidationErrorResponse:
      description: Validation failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StringErrorResponse'
          example:
            status: 422
            message: The selected card type is invalid.
            data: null
    TooManyRequestsResponse:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StringErrorResponse'
          example:
            status: 429
            message: Too Many Attempts.
            data: null
    InternalServerErrorResponse:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StringErrorResponse'
          example:
            status: 500
            message: Internal Server Error
            data: null
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: Client API key sent as a bearer token.
    directoryHeader:
      type: apiKey
      in: header
      name: X-Client-Directory
      description: Client directory identifier.

````

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