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

# Get All States

> GET /api/v1/einvoice/resources/states

**GET** `/api/v1/einvoice/resources/states`

## Request example

```bash theme={null}
curl -X GET "{{BASE_URL}}/api/v1/einvoice/resources/states" \
  -H "API-KEY: <your_api_key>" \
  -H "API-SECRET: <your_api_secret>" \
  -H "Accept: application/json"
```

## Response examples

**200**

```json theme={null}
{
  "code": 200,
  "data": [
    {
      "name": "Abia",
      "code": "NG-AB"
    },
    {
      "name": "Adamawa",
      "code": "NG-AD"
    },
    {
      "name": "Akwa Ibom",
      "code": "NG-AK"
    },
    {
      "name": "Anambra",
      "code": "NG-AN"
    },
    {
      "name": "Bauchi",
      "code": "NG-BA"
    },
    {
      "name": "Benue",
      "code": "NG-BE"
    },
    {
      "name": "Borno",
      "code": "NG-BO"
    },
    {
      "name": "Bayelsa",
      "code": "NG-BY"
    },
    {
      "name": "Cross River",
      "code": "NG-CR"
    },
    {
      "name": "Delta",
      "code": "NG-DE"
    },
    {
      "name": "Ebonyi",
      "code": "NG-EB"
    },
    {
      "name": "Edo",
      "code": "NG-ED"
    },
    {
      "name": "Ekiti",
      "code": "NG-EK"
    },
    {
      "name": "Enugu",
      "code": "NG-EN"
    },
    {
      "name": "Abuja Federal Capital Territory",
      "code": "NG-FC"
    },
    {
      "name": "Gombe",
      "code": "NG-GO"
    },
    {
      "name": "Imo",
      "code": "NG-IM"
    },
    {
      "name": "Jigawa",
      "code": "NG-JI"
    },
    {
      "name": "Kaduna",
      "code": "NG-KD"
    },
    {
      "name": "Kebbi",
      "code": "NG-KE"
    },
    {
      "name": "Kano",
      "code": "NG-KN"
    },
    {
      "name": "Kogi",
      "code": "NG-KO"
    },
    {
      "name": "Katsina",
      "code": "NG-KT"
    },
    {
      "name": "Kwara",
      "code": "NG-KW"
    },
    {
      "name": "Lagos",
      "code": "NG-LA"
    },
    {
      "name": "Nasarawa",
      "code": "NG-NA"
    },
    {
      "name": "Niger",
      "code": "NG-NI"
    },
    {
      "name": "Ogun",
      "code": "NG-OG"
    },
    {
      "name": "Ondo",
      "code": "NG-ON"
    },
    {
      "name": "Osun",
      "code": "NG-OS"
    },
    {
      "name": "Oyo",
      "code": "NG-OY"
    },
    {
      "name": "Plateau",
      "code": "NG-PL"
    },
    {
      "name": "Rivers",
      "code": "NG-RI"
    },
    {
      "name": "Sokoto",
      "code": "NG-SO"
    },
    {
      "name": "Taraba",
      "code": "NG-TA"
    },
    {
      "name": "Yobe",
      "code": "NG-YO"
    },
    {
      "name": "Zamfara",
      "code": "NG-ZA"
    }
  ]
}
```

**400**

```json theme={null}
{
  "status": false,
  "code": 400,
  "message": "Failed to validate invoice",
  "data": null,
  "error": {
    "id": "5c4c008e-8f1e-4034-a96b-8b352c143da5",
    "handler": "invoice_actions",
    "details": "this business does not exist",
    "public_message": "validation failed"
  },
  "timestamp": "2025-12-23T14:54:12.477393Z"
}
```

**401**

```json theme={null}
{
  "status": false,
  "code": 401,
  "message": "Unauthorized",
  "data": null,
  "error": {
    "details": "invalid or missing API credentials"
  }
}
```


## OpenAPI

````yaml GET /api/v1/einvoice/resources/states
openapi: 3.1.0
info:
  title: PASCA API
  version: 1.0.0
  description: PASCA eInvoicing API reference
servers:
  - url: https://test-api.pasca.co
    description: Sandbox
  - url: https://api.pasca.co
    description: Production
security:
  - ApiKey: []
    ApiSecret: []
  - APIKey: []
    APISecret: []
tags:
  - name: Resources
  - name: IRN and QR
  - name: Invoices
  - name: Transmission
  - name: Status and retrieval
  - name: Business
  - name: Health
paths:
  /api/v1/einvoice/resources/states:
    get:
      tags:
        - Resources
      summary: Get All States
      responses:
        '200':
          description: Get All States
          content:
            application/json:
              example:
                code: 200
                data:
                  - name: Abia
                    code: NG-AB
                  - name: Adamawa
                    code: NG-AD
                  - name: Akwa Ibom
                    code: NG-AK
                  - name: Anambra
                    code: NG-AN
                  - name: Bauchi
                    code: NG-BA
                  - name: Benue
                    code: NG-BE
                  - name: Borno
                    code: NG-BO
                  - name: Bayelsa
                    code: NG-BY
                  - name: Cross River
                    code: NG-CR
                  - name: Delta
                    code: NG-DE
                  - name: Ebonyi
                    code: NG-EB
                  - name: Edo
                    code: NG-ED
                  - name: Ekiti
                    code: NG-EK
                  - name: Enugu
                    code: NG-EN
                  - name: Abuja Federal Capital Territory
                    code: NG-FC
                  - name: Gombe
                    code: NG-GO
                  - name: Imo
                    code: NG-IM
                  - name: Jigawa
                    code: NG-JI
                  - name: Kaduna
                    code: NG-KD
                  - name: Kebbi
                    code: NG-KE
                  - name: Kano
                    code: NG-KN
                  - name: Kogi
                    code: NG-KO
                  - name: Katsina
                    code: NG-KT
                  - name: Kwara
                    code: NG-KW
                  - name: Lagos
                    code: NG-LA
                  - name: Nasarawa
                    code: NG-NA
                  - name: Niger
                    code: NG-NI
                  - name: Ogun
                    code: NG-OG
                  - name: Ondo
                    code: NG-ON
                  - name: Osun
                    code: NG-OS
                  - name: Oyo
                    code: NG-OY
                  - name: Plateau
                    code: NG-PL
                  - name: Rivers
                    code: NG-RI
                  - name: Sokoto
                    code: NG-SO
                  - name: Taraba
                    code: NG-TA
                  - name: Yobe
                    code: NG-YO
                  - name: Zamfara
                    code: NG-ZA
        '400':
          description: Bad Request
          content:
            application/json:
              example:
                status: false
                code: 400
                message: Failed to validate invoice
                data: null
                error:
                  id: 5c4c008e-8f1e-4034-a96b-8b352c143da5
                  handler: invoice_actions
                  details: this business does not exist
                  public_message: validation failed
                timestamp: '2025-12-23T14:54:12.477393Z'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                status: false
                code: 401
                message: Unauthorized
                data: null
                error:
                  details: invalid or missing API credentials
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: API-KEY
    ApiSecret:
      type: apiKey
      in: header
      name: API-SECRET
    APIKey:
      type: apiKey
      in: header
      name: API-KEY
    APISecret:
      type: apiKey
      in: header
      name: API-SECRET

````