GET
/functions/{function_id}/runsAuthorization
bearerAuth AuthorizationBearer <token>
Your Maton API key, sent as Authorization: Bearer <MATON_API_KEY>. Create one at https://maton.ai/settings.
In: header
Path Parameters
function_id*string
The function's unique identifier.
Query Parameters
limit?integer
Maximum number of runs to return.
Default
50next_token?string
Opaque pagination cursor from the previous response. Omit for the first page; absent/null in the response means the last page.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET \ "https://api.maton.ai/functions/{function_id}/runs?limit=5" \ -H "Authorization: Bearer $MATON_API_KEY"{
"runs": [
{
"run_id": "2f9d4c1b-6e3a-4f5b-9c7d-8e0a1b2c3d4e",
"function_id": "7c1e2f3a-9b4d-4c8e-a1f2-3b4c5d6e7f80",
"version": 3,
"request": {
"method": "POST",
"raw_path": "/",
"path": "/",
"raw_query_string": "",
"query_params": {},
"headers": {
"authorization": "[REDACTED]",
"content-type": "application/json",
"host": "my-fn-3k9xq2v.maton.app"
},
"cookies": [],
"body": "{\"name\": \"ada\"}",
"is_base64_encoded": false,
"source_ip": "203.0.113.7",
"user_agent": "maton/0.3.0",
"protocol": "HTTP/1.1",
"host": "my-fn-3k9xq2v.maton.app",
"label": "my-fn-3k9xq2v"
},
"response": {
"status": 200,
"headers": {
"content-type": "application/json"
},
"body": {
"greeting": "hi ada"
}
},
"created_at": "2026-08-31T22:41:02.113004Z",
"started_at": "2026-08-31T22:41:02.240118Z",
"ended_at": "2026-08-31T22:41:02.398772Z"
}
],
"next_token": null
}{
"message": "Invalid app name.",
"type": "Bad Request",
"code": 400
}{
"message": "Invalid API key.",
"type": "Unauthorized",
"code": 401
}{
"message": "Resource not found.",
"type": "Not Found",
"code": 404
}{
"message": "Too many requests.",
"type": "Too Many Requests",
"code": 429
}{
"message": "Internal server error.",
"type": "Internal Server Error",
"code": 500
}