> ## 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.

# Report E-Invoice

> POST /api/v1/einvoice/report-fiscalization

**POST** `/api/v1/einvoice/report-fiscalization`

## Request example

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

Request body:

```json theme={null}
{
  "agent_tin": "29039239-0001",
  "base_amount": "1000",
  "beneficiary_tin": "29334238-0001",
  "currency": "NGN",
  "item_description": "Items",
  "irn": "{{IRN}}",
  "other_taxes": "5000",
  "total_amount": "112500",
  "transaction_date": "2024-11-18",
  "vat_calculated": "7500",
  "vat_rate": "7.5",
  "vat_status": "STANDARD_VAT"
}
```

## Response examples

**200**

No example provided for this response.

**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 POST /api/v1/einvoice/report-fiscalization
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/report-fiscalization:
    post:
      tags:
        - Invoices
      summary: Report E-Invoice
      requestBody:
        required: true
        content:
          application/json:
            example:
              agent_tin: 29039239-0001
              base_amount: '1000'
              beneficiary_tin: 29334238-0001
              currency: NGN
              item_description: Items
              irn: '{{IRN}}'
              other_taxes: '5000'
              total_amount: '112500'
              transaction_date: '2024-11-18'
              vat_calculated: '7500'
              vat_rate: '7.5'
              vat_status: STANDARD_VAT
      responses:
        '200':
          description: Success
        '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

````