# Get project jobs

**GET /projects/{projectId}/jobs**

List jobs in project


## Servers
- Production environment: https://api.metafold3d.com (Production environment)
- Bleeding-edge (unstable) environment: https://dev-api.metafold3d.com (Bleeding-edge (unstable) environment)


## Authentication methods
- Oauth2


## Parameters

### Path parameters
- **projectId** (string)
  Project ID

### Query parameters
- **sort** (string)
  Sort string. Must be in the form `field:order`.
  `field` may be one of: id, name, created, started, or finished.
  `order` may be one of -1 for descending or 1 for ascending.
  Resources are sorted in descending order by id by default.
- **q** (string)
  Query string. See [search query syntax](/topic/topic-search-query-syntax) for
  details. Supported search fields are: id, name, type, and state.


## Responses
### 200
OK

#### Body: application/json (array[object])
- **id** (string)

- **name** (string | null)

- **type** (string)
  Type name
- **state** (string)
  Current job state
- **created** (string)
  ISO 8601 datetime
- **started** (string)
  ISO 8601 datetime
- **finished** (string)
  ISO 8601 datetime
- **error** (string | null)
  Error message for failed jobs
- **inputs** (object)
  Job assets and parameters
- **outputs** (object)
  Job assets and parameters
- **needs** (array[string])
  IDs of upstream dependencies
- **project_id** (string)
  Project ID
- **workflow_id** (string | null)
  Workflow ID, if part of a workflow

### 400
Bad Request

#### Body: application/json (object)
- **code** (integer)
  HTTP response code
- **name** (string)
  Status text corresponding to the HTTP response code
- **description** (string)
  Detailed error message

### 401
Unauthorized

#### Body: application/json (object)
- **code** (integer)
  HTTP response code
- **name** (string)
  Status text corresponding to the HTTP response code
- **description** (string)
  Detailed error message


[Powered by Bump.sh](https://bump.sh)