Humanloop Documentation and API Reference

Export all logged datapoints associated to your project.

Results are paginated and sorts the datapoints based on created_at in descending order.

Path parameters

idstringRequired

String ID of project. Starts with pr_.

Query parameters

pageintegerOptional

Page offset for pagination.

sizeintegerOptional

Page size for pagination. Number of logs to export.

Response

Successful Response

recordslist of objects

pageinteger

sizeinteger

totalinteger

Errors

1 curl -X POST https://api.humanloop.com/v4/projects/id/export \ 2 -H "X-API-KEY: <apiKey>"

1 { 2 "records": [ 3 { 4 "id": "id", 5 "config": { 6 "type": "generic", 7 "id": "config", 8 "name": "config", 9 "status": "config" 10 }, 11 "evaluation_results": [ 12 { 13 "id": "id", 14 "evaluator_id": "evaluator_id", 15 "evaluator_version_id": "evaluator_version_id", 16 "log_id": "log_id", 17 "updated_at": "2024-01-15T09:30:00Z", 18 "created_at": "2024-01-15T09:30:00Z" 19 } 20 ], 21 "observability_status": "pending", 22 "updated_at": "2024-01-15T09:30:00Z", 23 "project": "project", 24 "project_id": "project_id", 25 "session_id": "session_id", 26 "session_reference_id": "session_reference_id", 27 "parent_id": "parent_id", 28 "parent_reference_id": "parent_reference_id", 29 "inputs": { 30 "key": "value" 31 }, 32 "source": "source", 33 "metadata": { 34 "key": "value" 35 }, 36 "save": true, 37 "source_datapoint_id": "source_datapoint_id", 38 "reference_id": "reference_id", 39 "messages": [ 40 { 41 "role": "user" 42 } 43 ], 44 "output": "output", 45 "judgment": true, 46 "config_id": "config_id", 47 "environment": "environment", 48 "feedback": [ 49 { 50 "type": "rating", 51 "value": true, 52 "id": "id" 53 } 54 ], 55 "created_at": "2024-01-15T09:30:00Z", 56 "error": "error", 57 "stdout": "stdout", 58 "duration": 1.1, 59 "output_message": { 60 "role": "user" 61 }, 62 "prompt_tokens": 1, 63 "output_tokens": 1, 64 "prompt_cost": 1.1, 65 "output_cost": 1.1, 66 "provider_request": { 67 "key": "value" 68 }, 69 "provider_response": { 70 "key": "value" 71 }, 72 "user": "user", 73 "provider_latency": 1.1, 74 "tokens": 1, 75 "raw_output": "raw_output", 76 "finish_reason": "finish_reason", 77 "tools": [ 78 { 79 "id": "id", 80 "name": "name", 81 "signature": "signature", 82 "result": "result" 83 } 84 ], 85 "tool_choice": "none", 86 "batch_ids": [ 87 "batch_ids" 88 ] 89 } 90 ], 91 "page": 1, 92 "size": 1, 93 "total": 1 94 }

1	curl -X POST https://api.humanloop.com/v4/projects/id/export \
2	-H "X-API-KEY: <apiKey>"

1	{
2	"records": [
3	{
4	"id": "id",
5	"config": {
6	"type": "generic",
7	"id": "config",
8	"name": "config",
9	"status": "config"
10	},
11	"evaluation_results": [
12	{
13	"id": "id",
14	"evaluator_id": "evaluator_id",
15	"evaluator_version_id": "evaluator_version_id",
16	"log_id": "log_id",
17	"updated_at": "2024-01-15T09:30:00Z",
18	"created_at": "2024-01-15T09:30:00Z"
19	}
20	],
21	"observability_status": "pending",
22	"updated_at": "2024-01-15T09:30:00Z",
23	"project": "project",
24	"project_id": "project_id",
25	"session_id": "session_id",
26	"session_reference_id": "session_reference_id",
27	"parent_id": "parent_id",
28	"parent_reference_id": "parent_reference_id",
29	"inputs": {
30	"key": "value"
31	},
32	"source": "source",
33	"metadata": {
34	"key": "value"
35	},
36	"save": true,
37	"source_datapoint_id": "source_datapoint_id",
38	"reference_id": "reference_id",
39	"messages": [
40	{
41	"role": "user"
42	}
43	],
44	"output": "output",
45	"judgment": true,
46	"config_id": "config_id",
47	"environment": "environment",
48	"feedback": [
49	{
50	"type": "rating",
51	"value": true,
52	"id": "id"
53	}
54	],
55	"created_at": "2024-01-15T09:30:00Z",
56	"error": "error",
57	"stdout": "stdout",
58	"duration": 1.1,
59	"output_message": {
60	"role": "user"
61	},
62	"prompt_tokens": 1,
63	"output_tokens": 1,
64	"prompt_cost": 1.1,
65	"output_cost": 1.1,
66	"provider_request": {
67	"key": "value"
68	},
69	"provider_response": {
70	"key": "value"
71	},
72	"user": "user",
73	"provider_latency": 1.1,
74	"tokens": 1,
75	"raw_output": "raw_output",
76	"finish_reason": "finish_reason",
77	"tools": [
78	{
79	"id": "id",
80	"name": "name",
81	"signature": "signature",
82	"result": "result"
83	}
84	],
85	"tool_choice": "none",
86	"batch_ids": [
87	"batch_ids"
88	]
89	}
90	],
91	"page": 1,
92	"size": 1,
93	"total": 1
94	}