API Reference

Base URL: https://api.notarail.com/v1 · Auth: Bearer token · Format: JSON

Authentication

All API requests require a Bearer token in the Authorization header. Generate an API key in Settings → API (Growth plan required).

Authorization header

Authorization: Bearer ntr_live_sk_xxxxxxxxxxxxxxxxxxxx

GET /v1/meetings

Returns a paginated list of meetings processed by Notarail.

GET /v1/meetings

$ curl -H "Authorization: Bearer ntr_live_sk_xxx" \
     https://api.notarail.com/v1/meetings

200 OK
{
  "data": [
    {
      "id": "ntm_k9p2xq7r",
      "title": "Tuesday standup",
      "started_at": "2025-06-03T10:02:00Z",
      "duration_seconds": 740,
      "action_item_count": 3,
      "platform": "zoom"
    }
  ],
  "meta": {"page": 1, "per_page": 20, "total": 47}
}

GET /v1/meetings/:id/action-items

Returns all action items extracted from a specific meeting.

GET /v1/meetings/:id/action-items

$ curl -H "Authorization: Bearer ntr_live_sk_xxx" \
     https://api.notarail.com/v1/meetings/ntm_k9p2xq7r/action-items

200 OK
{
  "meeting_id": "ntm_k9p2xq7r",
  "action_items": [
    {
      "id": "nta_7xwm4p1q",
      "text": "Finalize API rate-limit spec",
      "assignee": "[email protected]",
      "due_date": "2025-06-03",
      "integration_status": "pushed",
      "external_id": "PROJ-1492"
    }
  ]
}

POST /v1/meetings/:id/push

Manually trigger a push of action items to a connected integration.

POST /v1/meetings/:id/push

$ curl -X POST \
     -H "Authorization: Bearer ntr_live_sk_xxx" \
     -H "Content-Type: application/json" \
     -d '{"integration": "jira", "project_key": "PROJ"}' \
     https://api.notarail.com/v1/meetings/ntm_k9p2xq7r/push

202 Accepted
{
  "push_id": "psh_x9k2mq4n",
  "status": "queued",
  "items_queued": 3
}

Rate limits

100 requests per minute per API key. Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Error codes

401 Unauthorized — Invalid or missing API key
403 Forbidden — API access requires Growth plan
404 Not Found — Resource not found
429 Too Many Requests — Rate limit exceeded
500 Internal Server Error — Contact [email protected]