Client get
GET /client/{id}
Get one OAuth client
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Internal client UUID (the id field returned by client list / detail endpoints, NOT the public clientId).
Query Parameters
includePermissions?string
When true, include the full permissions map.
includeUsageSummary?string
When true, attach a 30-day usage summary ({totalRequests, endpoints}).
includeScopes?string
When true, attach scopes.orgs[] + scopes.projects[] — every org / project grant on this client.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.part3.io/v1/client/4f5e6d7c-8b9a-4d2e-a3f5-678c9d0e1f2a"{
"id": "4f5e6d7c-8b9a-4d2e-a3f5-678c9d0e1f2a",
"clientId": "p3_8a1b2c3d4e5f60718293a4b5c6d7e8f9",
"name": "AcmeCorp Project Sync",
"description": "Backend job that mirrors AcmeCorp project metadata into our PM system.",
"superadmin": false,
"enabled": true,
"createdBy": "admin@part3.io",
"createdAt": "2026-01-08T19:24:00Z",
"permissions": {
"mcp:access": true,
"organization:read": true,
"project:read": true,
"document:read": true,
"email:read": true,
"client:read": false,
"client:create": false,
"explorer:query": false
},
"usageSummary": {
"totalRequests": 14280,
"endpoints": [
{
"endpoint": "GET /v1/document",
"count": 8421,
"averageResponseTimeMs": 142.18
}
]
},
"scopes": {
"orgs": [
{
"orgId": "org_8a1b2c3d4e",
"grantedAt": "2026-01-08T19:25:00Z"
}
],
"projects": [
{
"orgId": "org_8a1b2c3d4e",
"projectId": "proj_5f9a3c2e8b",
"grantedAt": "2026-01-08T19:25:00Z"
}
]
}
}{
"error": "Client token required"
}{
"error": "Client token required"
}