Skip to main content
GET
/
api
/
projects
/
{id}
Get a project
curl --request GET \
  --url https://api.mentionlab.io/api/projects/{id} \
  --header 'x-project-id: <x-project-id>'
{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "name": "My Project",
  "recurrence": "0 1 1 * *",
  "recurrenceStatus": "active",
  "llmProviders": [
    "openai",
    "anthropic"
  ],
  "executionCount": 3,
  "organisation": "01234567-89ab-cdef-0123-456789abcdef",
  "updatedAt": "2021-01-01T00:00:00.000Z",
  "recurrenceTimezone": "Europe/Brussels",
  "slug": "my-project",
  "description": "My Project Description",
  "industry": "Technology",
  "website": "https://www.mentionlab.io",
  "nameAliases": [
    "My Project",
    "My Project 2"
  ],
  "blackListAliases": [
    "My Project",
    "My Project 2"
  ],
  "currentPo": "PO-2026-Q2-1234"
}

Headers

​
x-project-id
string
required

Project ID to specify the project context

Path Parameters

​
id
string
required

Unique identifier of the project to retrieve.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

​
id
string
required

Unique identifier for the project

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
name
string
required

Name of the project

Example:

"My Project"

​
recurrence
string
required

The recurrence of the project, either a CRON expression or "manual"

Example:

"0 1 1 * *"

​
recurrenceStatus
enum<string>
required

Recurrence status of the project

Available options:
active,
paused
Example:

"active"

​
llmProviders
string[]
required

LLM providers of the project

Example:
["openai", "anthropic"]
​
executionCount
number
required

Execution count of the project

Example:

3

​
organisation
object
required

Organisation that owns this project

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
updatedAt
string<date-time>
required

Last update timestamp

Example:

"2021-01-01T00:00:00.000Z"

​
recurrenceTimezone
string
required

The timezone for the recurrence cron expression, as a valid IANA timezone string

Example:

"Europe/Brussels"

​
slug
string

Slug of the project

Example:

"my-project"

​
description
string

Description of the project

Example:

"My Project Description"

​
industry
string

Industry of the project

Example:

"Technology"

​
website
string

Website of the project

Example:

"https://www.mentionlab.io"

​
nameAliases
string[]

Name aliases of the project

Example:
["My Project", "My Project 2"]
​
blackListAliases
string[]

Blacklist aliases of the project

Example:
["My Project", "My Project 2"]
​
currentPo
string

Active purchase order reference for this project.

Example:

"PO-2026-Q2-1234"