List routes for a domain

Returns a paginated list of routes attached to the domain. Optionally filter by an agent identifier to find routes pointing to a specific agent.

GET /v1/domains/{domain}/routes

TypeScript

TypeScript

import { Novu } from "@novu/api";

const novu = new Novu({
  secretKey: "YOUR_SECRET_KEY_HERE",
});

async function run() {
  const result = await novu.domains.routes.list({
    domain: "fearless-fishery.com",
    limit: 10,
  });

  console.log(result);
}

run();

200

{
  "data": [
    {
      "_id": "<string>",
      "_domainId": "<string>",
      "address": "<string>",
      "_environmentId": "<string>",
      "_organizationId": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "agentId": "<string>",
      "data": {}
    }
  ],
  "next": "<string>",
  "previous": "<string>",
  "totalCount": 123,
  "totalCountCapped": true
}

Authorizations

Authorization · string · header · required

API key authentication. Allowed headers-- "Authorization: ApiKey <novu_secret_key>".

Headers

idempotency-key · string

A header for idempotency purposes

Path Parameters

domain · string · required

Query Parameters

after · string

Cursor for pagination indicating the starting point after which to fetch results.

before · string

Cursor for pagination indicating the ending point before which to fetch results.

limit · number

Limit the number of items to return

orderDirection · enum<string>

Direction of sorting

Available options: ASC, DESC

orderBy · string

Field to order by

includeCursor · boolean

Include cursor item in response

agentId · string

Agent identifier to filter routes by.

Response

200

application/json

OK

data · object[] · required

List of returned domain routes

Show child attributes

next · string | null · required

The cursor for the next page of results, or null if there are no more pages.

previous · string | null · required

The cursor for the previous page of results, or null if this is the first page.

totalCount · number · required

The total count of items (up to 50,000)

totalCountCapped · boolean · required

Whether there are more than 50,000 results available