---
title: "Get All"
method: GET
path: "/entity/{entityId}/user/{userId}/notifications"
tags: ["entity > user > notifications"]
---

# Get All

`GET /entity/{entityId}/user/{userId}/notifications`

## Request

- Base URL: `https://api.mercoa.com`
- URL: `https://api.mercoa.com/entity/{entityId}/user/{userId}/notifications`
- Auth: HTTP bearer

## Path parameters

- `entityId` string, required
- `userId` string, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `orderDirection` 'ASC' | 'DESC'
- `limit` integer
- `startingAfter` string
- `notificationType` 'INVOICE_APPROVAL_NEEDED' | 'INVOICE_APPROVED' | 'INVOICE_REJECTED' | 'INVOICE_SCHEDULED' | 'INVOICE_PENDING' | 'INVOICE_PAID' | 'INVOICE_CANCELED' | 'INVOICE_CREATED' | 'INVOICE_EMAILED' | 'INVOICE_FAILED' | 'COUNTERPARTY_ONBOARDING_COMPLETED'
- `status` 'PENDING' | 'SENT' | 'READ' | 'FAILED'

## Response `200`

Response with status 200

- EntityTypesFindNotificationResponse
  - `count` integer, required: Total number of notifications for the given start and end date filters. This value is not limited by the limit parameter. It is provided so that you can determine how many pages of results are available.
  - `hasMore` boolean, required: True if there are more notifications available for the given start and end date filters.
  - `data` EntityTypesNotificationResponse[], required
    - `id` string, required
    - `invoiceId` string
    - `type` 'INVOICE_APPROVAL_NEEDED' | 'INVOICE_APPROVED' | 'INVOICE_REJECTED' | 'INVOICE_SCHEDULED' | 'INVOICE_PENDING' | 'INVOICE_PAID' | 'INVOICE_CANCELED' | 'INVOICE_CREATED' | 'INVOICE_EMAILED' | 'INVOICE_FAILED' | 'COUNTERPARTY_ONBOARDING_COMPLETED', required
    - `status` 'PENDING' | 'SENT' | 'READ' | 'FAILED', required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `409`: Error response with status 409
- `500`: Error response with status 500
- `501`: Error response with status 501

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)