---
title: "POST /FI/Notification"
method: POST
path: "/FI/Notification"
tags: ["Notifications"]
---

# POST /FI/Notification

`POST /FI/Notification`

This API can be used by AAs to send notifications related to Financial Information (FI) fetch to FIU/AA Client.
<br>Note: "Request Body Example Value" and "Responses Example Value" given below is for illustrative purposes only.

## Headers

- `aa_api_key` unknown, required
- `x-jws-signature` string, required
- `x-request-meta` string, required

## Request body

- FIStatusNotificationRequestWrapper
  - `ver` string, required — API version
  - `timestamp` string, date-time, required — Creation timestamp of the message
  - `txnid` string, required — The unique transaction identifier used for providing an end to end traceability.
  - `Notifier` object, required — Information about the notifier
    - `type` string, required — Type of the notifier entity
    - `id` string, required — Unique ID to identify the entity
  - `FIStatusNotification` object, required — Contains the financial information fetch session id and session status details.
    - `sessionId` string, required — A session ID is a base-64 encoded UUID number that an AA returns to the FIU or AA Client for each financial information access request.
    - `sessionStatus` 'ACTIVE' | 'COMPLETED' | 'EXPIRED' | 'FAILED', required — Status of the Financial Information fetch session.
    - `FIStatusResponse` object[], required
      - `fipID` string, required — FIP ID as defined in the Account Aggregator Ecosystem.
      - `Accounts` object[], required
        - `linkRefNumber` string, required — Reference number assigned by FIP as part of Account Linking Process.
        - `FIStatus` 'READY' | 'DENIED' | 'PENDING' | 'DELIVERED' | 'TIMEOUT', required — Fetch Status of the Financial Information.
        - `description` string, required

## Response `200`

OK

- NotificationResponse — Success response for receiving notification
  - `ver` string, required — API version
  - `timestamp` string, date-time, required — Creation timestamp of the message
  - `txnid` string, required — Unique transaction identifier used for providing an end to end traceability.
  - `response` string, required — Response description

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Access
- `404` — Not Found
- `409` — Conflict
- `412` — Precondition failed
- `500` — Internal Server Error
- `501` — Not Implemented
- `503` — Service Unavailable

---

[API](https://skmtc.net/gitbookio/apis/financial-information-user-callback-api.md) · [All operations](https://skmtc.net/gitbookio/apis/financial-information-user-callback-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitbookio/financial-information-user-callback-api/revisions/26f19f79f17b/schema)