Projects

List projects

List the projects (matters or cases) the caller can see, newest first by default. Filter by name, linked account or contact, and when projects were created or updated.

get/projects

Request

  • Base URL
    https://api.parley.so/v1
  • URL
    https://api.parley.so/v1/projects
  • Auth
    HTTP bearer

Query parameters

searchstring

Case-insensitive. Every word must match the project name or a text custom field.

accountIdstring

Only projects linked to this account, directly or through one of its contacts.

contactIdstring

Only projects linked to this contact.

createdSincestring

Only records created at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

createdBeforestring

Only records created before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

updatedSincestring

Only records last updated at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

updatedBeforestring

Only records last updated before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

sort'name' | '-name' | 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt'

Sort order: a field name, prefixed with - for descending. Defaults to -createdAt.

cursorstring

Opaque cursor from nextCursor. Pass the same filters and sort. Omit for the first page.

limitinteger

Maximum number of items to return.

Response

OK

nextCursorstring nullable required

Cursor for the next page, or null on the last page.

Example response

{
  "data": [
    {
      "id": "cmf2x8k0q0001abcd",
      "name": "Acme Corp H-1B petition",
      "access": {
        "type": "everyone"
      },
      "accounts": [
        {
          "type": "account",
          "id": "cmf2x7r1p0000abcd",
          "name": "Acme Corp"
        }
      ],
      "contacts": [
        {
          "type": "contact",
          "id": "cmf2x7z3e0002abcd",
          "name": "Ada Lovelace"
        }
      ],
      "createdAt": "2026-10-01T15:04:05.000Z",
      "updatedAt": "2026-10-02T09:30:00.000Z",
      "fields": {
        "Matter Number": "IMM-2041",
        "Target Date": null
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.