Get project

Returns metadata and field definitions for a single project.

Request

string

required

Bearer token for a workspace API key scoped to this workspace.

string

required

Workspace slug.

integer

required

Project ID.

curl "https://app.askgrapple.com/api/v1/workspaces/acme-corp/projects/42" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

object

Project details.

Show properties

integer

Project ID.

string

Project name.

integer | null

Number of materialized rows in the project.

string | null

Materialization state: up_to_date, updating, or error.

array

Fields defined on the project.

Show field object

integer

Field ID.

string

Field display name.

string

Presentation type for the field.

string

ISO 8601 timestamp when the project was created.

string

ISO 8601 timestamp when the project was last updated.

{
  "data": {
    "id": 42,
    "name": "Q1 Pipeline",
    "record_count": 1280,
    "materialization_status": "up_to_date",
    "fields": [
      {
        "id": 101,
        "name": "Deal Name",
        "type": "string"
      }
    ],
    "created_at": "2026-01-15T10:30:00.000000Z",
    "updated_at": "2026-03-01T14:22:00.000000Z"
  }
}

Errors

Status	Reason
`401`	Missing or invalid API key
`403`	API key does not belong to this workspace
`404`	Project not found in this workspace

Getting Started

Data Library

Projects

API

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors