List projects

/api/v1/projects

/api/v1/projects

List projects

Endpoint

  • Method: GET
  • Path: /api/v1/projects

Base URL

https://api.mentionkit.com

Authentication

Use Authorization: Bearer YOUR_API_KEY.

Parameters

No parameters.

Responses

200: Projects fetched successfully.

  • Content-Type: application/json
  • Schema: ProjectListResponse
  • Example:
{
  "items": [
    {
      "id": 3001,
      "name": "Example Project",
      "siteUrl": "https://example.com",
      "siteDomain": "example.com",
      "bizName": "ExampleCo",
      "description": "ExampleCo helps teams monitor social mentions and respond faster.",
      "type": "ECOM",
      "faviconUrl": "https://example.com/favicon.ico",
      "createdAt": "2026-03-21T00:26:05.651Z",
      "updatedAt": "2026-03-24T01:29:08.985Z"
    }
  ],
  "total": 1
}

401: Missing or invalid API key.

  • Content-Type: application/json
  • Schema: ErrorResponse

403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.

  • Content-Type: application/json
  • Schema: ErrorResponse
  • Example:
{
  "error": "API access requires a trial, paid subscription, or billing exemption"
}

500: Unexpected server error.

  • Content-Type: application/json
  • Schema: ErrorResponse

Error codes

  • 401: Missing or invalid API key.
  • 403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.
  • 500: Unexpected server error.