List jobs — Flatfile | API Reference

Headers

X-Disable-Hooks"true"Required

Query parameters

environmentIdstringOptional

When provided, only jobs for the given environment will be returned

spaceIdstringOptional

When provided, only jobs for the given space will be returned

workbookIdstringOptional

When provided, only jobs for the given workbook will be returned

fileIdstringOptional

When provided, only jobs for the given file will be returned

parentIdstringOptional

When provided, only jobs that are parts of the given job will be returned

pageSizeintegerOptional

Number of jobs to return in a page (default 20)

pageNumberintegerOptional

Based on pageSize, which page of jobs to return

sortDirection"asc" or "desc"Optional

Sort direction - asc (ascending) or desc (descending)

Allowed values: ascdesc

excludeChildJobsbooleanOptional

When true, only top-level jobs will be returned unless a parentId is specified

Response

This endpoint returns an object.

datalist of objects

paginationobjectOptional

pagination info

1 curl -G https://api.x.flatfile.com/v1/jobs \ 2 -H "X-Disable-Hooks: true" \ 3 -H "Authorization: Bearer <token>" \ 4 -d environmentId=us_env_YOUR_ID \ 5 -d spaceId=us_sp_YOUR_ID

1 { 2 "data": [ 3 { 4 "createdAt": "2023-10-30T20:04:28.556Z", 5 "id": "us_jb_YOUR_ID", 6 "operation": "submitAction", 7 "source": "us_wb_YOUR_ID", 8 "type": "workbook", 9 "updatedAt": "2023-10-30T20:04:32.075Z", 10 "config": {}, 11 "destination": "us_wb_YOUR_ID", 12 "environmentId": "us_env_YOUR_ID", 13 "fileId": "us_fl_YOUR_ID", 14 "finishedAt": "2023-10-30T20:04:32.074Z", 15 "info": "Starting job to submit action to webhook.site", 16 "input": {}, 17 "managed": true, 18 "mode": "foreground", 19 "outcome": { 20 "message": "Data was successfully submitted to Webhook.site. Go check it out at https://example.site/example." 21 }, 22 "progress": 100, 23 "startedAt": "2023-10-30T20:04:29.453Z", 24 "status": "complete", 25 "subject": { 26 "type": "resource", 27 "id": "us_wb_YOUR_ID" 28 }, 29 "trigger": "immediate" 30 } 31 ], 32 "pagination": { 33 "currentPage": 3, 34 "pageCount": 50, 35 "totalCount": 100 36 } 37 }

1	curl -G https://api.x.flatfile.com/v1/jobs \
2	-H "X-Disable-Hooks: true" \
3	-H "Authorization: Bearer <token>" \
4	-d environmentId=us_env_YOUR_ID \
5	-d spaceId=us_sp_YOUR_ID

1	{
2	"data": [
3	{
4	"createdAt": "2023-10-30T20:04:28.556Z",
5	"id": "us_jb_YOUR_ID",
6	"operation": "submitAction",
7	"source": "us_wb_YOUR_ID",
8	"type": "workbook",
9	"updatedAt": "2023-10-30T20:04:32.075Z",
10	"config": {},
11	"destination": "us_wb_YOUR_ID",
12	"environmentId": "us_env_YOUR_ID",
13	"fileId": "us_fl_YOUR_ID",
14	"finishedAt": "2023-10-30T20:04:32.074Z",
15	"info": "Starting job to submit action to webhook.site",
16	"input": {},
17	"managed": true,
18	"mode": "foreground",
19	"outcome": {
20	"message": "Data was successfully submitted to Webhook.site. Go check it out at https://example.site/example."
21	},
22	"progress": 100,
23	"startedAt": "2023-10-30T20:04:29.453Z",
24	"status": "complete",
25	"subject": {
26	"type": "resource",
27	"id": "us_wb_YOUR_ID"
28	},
29	"trigger": "immediate"
30	}
31	],
32	"pagination": {
33	"currentPage": 3,
34	"pageCount": 50,
35	"totalCount": 100
36	}
37	}