> For the complete documentation index, see [llms.txt](https://docs.humanity.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humanity.org/api-reference/reference/models.md).

# Models

## The AuthorizeQuery object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeQuery":{"type":"object","properties":{"client_id":{"type":"string"},"redirect_uri":{"type":"string"},"response_type":{"const":"code"},"scope":{"type":"string"},"state":{"type":"string"},"code_challenge":{"type":"string"},"code_challenge_method":{"const":"S256"},"authorization_id":{"type":"string"},"login_hint":{"type":"string"},"locale":{"type":"string"},"nonce":{"type":"string"}},"required":["client_id","redirect_uri","response_type","scope","code_challenge","code_challenge_method"]}}}}
```

## The TokenResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"TokenResponse":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"const":"Bearer"},"expires_in":{"type":"number"},"scope":{"type":"string"},"granted_scopes":{"type":"array","items":{"type":"string"}},"authorization_id":{"type":"string"},"app_scoped_user_id":{"type":"string"},"issued_at":{"type":"string"},"refresh_token":{"type":"string"},"refresh_token_expires_in":{"type":"number"},"refresh_issued_at":{"type":"string"},"id_token":{"type":"string"}},"required":["access_token","token_type","expires_in","scope","granted_scopes","authorization_id","app_scoped_user_id"]}}}}
```

## The ClientUserTokenResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"ClientUserTokenResponse":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"const":"Bearer"},"expires_in":{"type":"number"},"issued_at":{"type":"string"},"user_id":{"type":"string"},"client_id":{"type":"string"},"authorization_id":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["access_token","token_type","expires_in","issued_at","user_id","client_id","authorization_id","scopes"]}}}}
```

## The ClientUserTokenRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"ClientUserTokenRequest":{"type":"object","properties":{"client_id":{"type":"string"},"client_secret":{"type":"string"},"identifier":{"type":"string"},"user_id":{"type":"string"},"email":{"type":"string"},"evm_address":{"type":"string"}},"required":["client_id","client_secret"]}}}}
```

## The AuthorizeContextResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeContextResponse":{"type":"object","properties":{"authorization_id":{"type":"string"},"client_id":{"type":"string"},"user_id":{"type":"string"},"app_scoped_user_id":{"type":"string"},"status":{"oneOf":[{"const":"pending_admin"},{"const":"approved"},{"const":"denied"},{"const":"revoked"},{"const":"consumed"}]},"redirect_uri":{"type":"string"},"state":{"type":"string"},"requested_scopes":{"type":"array","items":{"type":"string"}},"granted_scopes":{"type":"array","items":{"type":"string"}},"code":{"type":"string"},"code_expires_at":{"type":"string"},"nonce":{"type":"string"},"application":{"$ref":"#/components/schemas/AuthorizeApplicationDetail"},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/AuthorizeScopeDetail"}},"metadata":{"$ref":"#/components/schemas/AuthorizeContextMetadata"},"policy":{"$ref":"#/components/schemas/AuthorizeContextPolicy"}},"required":["authorization_id","client_id","user_id","app_scoped_user_id","status","redirect_uri","requested_scopes","application","scopes","metadata","policy"]},"AuthorizeApplicationDetail":{"type":"object","properties":{"client_id":{"type":"string"},"name":{"type":"string"},"organization_id":{"type":"string"},"status":{"oneOf":[{"const":"active"},{"const":"revoked"}]},"redirect_uris":{"type":"array","items":{"type":"string"}},"created_by_user_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"revoked_at":{"type":"string"}},"required":["client_id","name","organization_id","status","redirect_uris"]},"AuthorizeScopeDetail":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"implied_scopes":{"type":"array","items":{"type":"string"}},"is_default":{"type":"boolean"}},"required":["id","display_name"]},"AuthorizeContextMetadata":{"type":"object","properties":{"created_at":{"type":"string"},"updated_at":{"type":"string"},"approved_at":{"type":"string"},"revoked_at":{"type":"string"},"last_token_issued_at":{"type":"string"}},"required":[]},"AuthorizeContextPolicy":{"type":"object","properties":{"requires_palm_verification":{"type":"boolean"},"preset_cache_ttl_seconds":{"type":"number"}},"required":["requires_palm_verification","preset_cache_ttl_seconds"]}}}}
```

## The AuthorizeApplicationDetail object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeApplicationDetail":{"type":"object","properties":{"client_id":{"type":"string"},"name":{"type":"string"},"organization_id":{"type":"string"},"status":{"oneOf":[{"const":"active"},{"const":"revoked"}]},"redirect_uris":{"type":"array","items":{"type":"string"}},"created_by_user_id":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"revoked_at":{"type":"string"}},"required":["client_id","name","organization_id","status","redirect_uris"]}}}}
```

## The AuthorizeScopeDetail object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeScopeDetail":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"implied_scopes":{"type":"array","items":{"type":"string"}},"is_default":{"type":"boolean"}},"required":["id","display_name"]}}}}
```

## The AuthorizeContextMetadata object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeContextMetadata":{"type":"object","properties":{"created_at":{"type":"string"},"updated_at":{"type":"string"},"approved_at":{"type":"string"},"revoked_at":{"type":"string"},"last_token_issued_at":{"type":"string"}},"required":[]}}}}
```

## The AuthorizeContextPolicy object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeContextPolicy":{"type":"object","properties":{"requires_palm_verification":{"type":"boolean"},"preset_cache_ttl_seconds":{"type":"number"}},"required":["requires_palm_verification","preset_cache_ttl_seconds"]}}}}
```

## The AuthorizeContextQuery object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeContextQuery":{"type":"object","properties":{"authorization_id":{"type":"string"}},"required":["authorization_id"]}}}}
```

## The AuthorizeResultQuery object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeResultQuery":{"type":"object","properties":{"authorization_id":{"type":"string"}},"required":["authorization_id"]}}}}
```

## The RevokeResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"RevokeResponse":{"type":"object","properties":{"revoked":{"type":"boolean"},"revoked_count":{"type":"number"},"details":{"type":"array","items":{"$ref":"#/components/schemas/RevokedTokenDetail"}}},"required":["revoked","revoked_count"]},"RevokedTokenDetail":{"type":"object","properties":{"subject":{"oneOf":[{"const":"token"},{"const":"authorization"}]},"token_type":{"oneOf":[{"const":"refresh_token"},{"const":"access_token"}]},"authorization_id":{"type":"string"},"client_id":{"type":"string"},"user_id":{"type":"string"},"status":{"oneOf":[{"const":"revoked"},{"const":"not_found"},{"const":"invalid"}]},"reason":{"type":"string"}},"required":["subject","status"]}}}}
```

## The RevokedTokenDetail object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"RevokedTokenDetail":{"type":"object","properties":{"subject":{"oneOf":[{"const":"token"},{"const":"authorization"}]},"token_type":{"oneOf":[{"const":"refresh_token"},{"const":"access_token"}]},"authorization_id":{"type":"string"},"client_id":{"type":"string"},"user_id":{"type":"string"},"status":{"oneOf":[{"const":"revoked"},{"const":"not_found"},{"const":"invalid"}]},"reason":{"type":"string"}},"required":["subject","status"]}}}}
```

## The RevokeRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"RevokeRequest":{"type":"object","properties":{"token":{"type":"string"},"tokens":{"type":"array","items":{"type":"string"}},"token_type_hint":{"oneOf":[{"const":"authorization"},{"const":"refresh_token"},{"const":"access_token"}]},"authorization_id":{"type":"string"},"cascade":{"oneOf":[{"const":"0"},{"const":"true"},{"const":"false"},{"const":"1"},{"type":"boolean"}]},"client_id":{"type":"string"}},"required":[]}}}}
```

## The AuthorizeApproveResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeApproveResponse":{"type":"object","properties":{"authorization_id":{"type":"string"},"status":{"const":"approved"},"code":{"type":"string"},"code_expires_at":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"granted_scopes":{"type":"array","items":{"type":"string"}},"app_scoped_user_id":{"type":"string"},"organization_id":{"type":"string"},"state":{"type":"string"},"redirect_uri":{"type":"string"},"client_id":{"type":"string"}},"required":["authorization_id","status","code","code_expires_at","scopes","granted_scopes","app_scoped_user_id","organization_id","redirect_uri","client_id"]}}}}
```

## The AuthorizeApproveRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizeApproveRequest":{"type":"object","properties":{"authorization_id":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["authorization_id"]}}}}
```

## The UserInfoResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"UserInfoResponse":{"type":"object","properties":{"sub":{"type":"string"},"iss":{"type":"string"},"aud":{"type":"string"},"authorization_id":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"updated_at":{"type":"string"},"humanity_id":{"oneOf":[{"type":"null"},{"type":"string"}]},"wallet_address":{"oneOf":[{"type":"null"},{"type":"string"}]},"email":{"oneOf":[{"type":"null"},{"type":"string"}]},"email_verified":{"type":"boolean"}},"required":["sub","iss","aud","authorization_id","scopes"]}}}}
```

## The OrganizationView object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"OrganizationView":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ownerId":{"oneOf":[{"type":"null"},{"type":"string"}]},"isOwner":{"type":"boolean"}},"required":["id","name","ownerId","isOwner"]}}}}
```

## The UpdateOrganizationRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"UpdateOrganizationRequest":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}}
```

## The PresetResult object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PresetResult":{"type":"object","properties":{"preset":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"value":{},"status":{"oneOf":[{"const":"valid"},{"const":"pending"},{"const":"expired"},{"const":"unavailable"}]},"expires_at":{"type":"string"},"verified_at":{"type":"string"},"evidence":{"$ref":"#/components/schemas/Recordstringunknown"}},"required":["preset","value","status","expires_at"]},"Recordstringunknown":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{}}}}}
```

## The Recordstringunknown object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"Recordstringunknown":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{}}}}}
```

## The VerifyPresetsResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"VerifyPresetsResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/PresetResult"}},"errors":{"type":"array","items":{"type":"object","properties":{"preset":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"error":{"$ref":"#/components/schemas/PresetError"}},"required":["preset","error"]}}},"required":["results","errors"]},"PresetResult":{"type":"object","properties":{"preset":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"value":{},"status":{"oneOf":[{"const":"valid"},{"const":"pending"},{"const":"expired"},{"const":"unavailable"}]},"expires_at":{"type":"string"},"verified_at":{"type":"string"},"evidence":{"$ref":"#/components/schemas/Recordstringunknown"}},"required":["preset","value","status","expires_at"]},"Recordstringunknown":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{}},"PresetError":{"type":"object","properties":{"error":{"type":"string"},"error_code":{"oneOf":[{"const":"E4003","description":"Insufficient scope for the requested preset data; see Appendix J Error Codes (E4003) and Appendix O Advanced Consent Management (revoked scopes)."},{"const":"E4004","description":"Preset is unavailable because verification is pending, revoked, or incomplete; documented in Appendix J Error Codes (E4004) and Appendix D Developer Flows."},{"const":"E4010","description":"Cached preset data has expired and requires reauthorization; described in Appendix B API Reference preset expiration response."},{"const":"E4041","description":"OAuth access token is expired; covered in Appendix J Error Codes (E4041 Token Expired)."},{"const":"E4042","description":"OAuth access token is invalid due to revocation, mismatch, or signature issues; detailed in Appendix J Error Codes (E4042 Invalid Token)."},{"const":"E4044","description":"Requested preset resource cannot be found; specified in Appendix J Error Codes (E4044 Not Found)."}]},"error_description":{"type":"string"},"error_subcode":{"type":"string"},"context":{"$ref":"#/components/schemas/Recordstringstringnumberbooleanstringnull"}},"required":["error","error_code","error_description"]},"Recordstringstringnumberbooleanstringnull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":"string"}}]}}}}}
```

## The PresetError object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PresetError":{"type":"object","properties":{"error":{"type":"string"},"error_code":{"oneOf":[{"const":"E4003","description":"Insufficient scope for the requested preset data; see Appendix J Error Codes (E4003) and Appendix O Advanced Consent Management (revoked scopes)."},{"const":"E4004","description":"Preset is unavailable because verification is pending, revoked, or incomplete; documented in Appendix J Error Codes (E4004) and Appendix D Developer Flows."},{"const":"E4010","description":"Cached preset data has expired and requires reauthorization; described in Appendix B API Reference preset expiration response."},{"const":"E4041","description":"OAuth access token is expired; covered in Appendix J Error Codes (E4041 Token Expired)."},{"const":"E4042","description":"OAuth access token is invalid due to revocation, mismatch, or signature issues; detailed in Appendix J Error Codes (E4042 Invalid Token)."},{"const":"E4044","description":"Requested preset resource cannot be found; specified in Appendix J Error Codes (E4044 Not Found)."}]},"error_description":{"type":"string"},"error_subcode":{"type":"string"},"context":{"$ref":"#/components/schemas/Recordstringstringnumberbooleanstringnull"}},"required":["error","error_code","error_description"]},"Recordstringstringnumberbooleanstringnull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":"string"}}]}}}}}
```

## The Recordstringstringnumberbooleanstringnull object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"Recordstringstringnumberbooleanstringnull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":"string"}}]}}}}}
```

## The VerifyPresetsRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"VerifyPresetsRequest":{"type":"object","properties":{"presets":{"type":"array","items":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]}}},"required":["presets"]}}}}
```

## The PresetsListResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PresetsListResponse":{"type":"object","properties":{"presets":{"type":"array","items":{"$ref":"#/components/schemas/PresetInfo"}}},"required":["presets"]},"PresetInfo":{"type":"object","properties":{"name":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"scope":{"oneOf":[{"const":"identity:read"},{"const":"kyc:read"},{"const":"financial:read"},{"const":"identity:date_of_birth"},{"const":"identity:address_postal_code"},{"const":"identity:address_full"},{"const":"identity:legal_name"},{"const":"kyc:document_number"},{"const":"financial:bank_balance"},{"const":"financial:loan_balance"},{"const":"financial:net_worth"},{"const":"openid"},{"const":"profile.full"},{"const":"data.read"}]},"category":{"oneOf":[{"const":"identity"},{"const":"kyc"},{"const":"financial"},{"const":"profile"}]},"description":{"type":"string"},"consentText":{"type":"string"},"type":{"oneOf":[{"const":"string"},{"const":"number"},{"const":"boolean"},{"const":"date"},{"const":"datetime"},{"const":"integer"},{"const":"array"},{"const":"enum"}]},"sensitivity":{"oneOf":[{"const":"low"},{"const":"medium"},{"const":"high"},{"const":"critical"}]},"derived":{"type":"boolean"},"parentField":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]}},"required":["name","scope","category","description","consentText","type","sensitivity","derived"],"description":"Full preset info including scope and category."}}}}
```

## The PresetInfo object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PresetInfo":{"type":"object","properties":{"name":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"scope":{"oneOf":[{"const":"identity:read"},{"const":"kyc:read"},{"const":"financial:read"},{"const":"identity:date_of_birth"},{"const":"identity:address_postal_code"},{"const":"identity:address_full"},{"const":"identity:legal_name"},{"const":"kyc:document_number"},{"const":"financial:bank_balance"},{"const":"financial:loan_balance"},{"const":"financial:net_worth"},{"const":"openid"},{"const":"profile.full"},{"const":"data.read"}]},"category":{"oneOf":[{"const":"identity"},{"const":"kyc"},{"const":"financial"},{"const":"profile"}]},"description":{"type":"string"},"consentText":{"type":"string"},"type":{"oneOf":[{"const":"string"},{"const":"number"},{"const":"boolean"},{"const":"date"},{"const":"datetime"},{"const":"integer"},{"const":"array"},{"const":"enum"}]},"sensitivity":{"oneOf":[{"const":"low"},{"const":"medium"},{"const":"high"},{"const":"critical"}]},"derived":{"type":"boolean"},"parentField":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]}},"required":["name","scope","category","description","consentText","type","sensitivity","derived"],"description":"Full preset info including scope and category."}}}}
```

## The PredicateEvaluateResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PredicateEvaluateResponse":{"type":"object","properties":{"type":{"const":"predicate"},"passed":{"type":"boolean","description":"Whether the query passed."},"evaluatedAt":{"type":"string","description":"Timestamp when the query was evaluated."},"evidence":{"type":"object","properties":{"claimsUsed":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"value":{},"credentialId":{"type":"string"},"source":{"type":"string"}},"required":["path","value"]}},"checkResults":{"type":"array","items":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"type":"string"},"expectedValue":{},"actualValue":{},"passed":{"type":"boolean"}},"required":["claim","operator","expectedValue","actualValue","passed"]}}},"required":["claimsUsed","checkResults"],"description":"Evidence collected during evaluation."},"expiresAt":{"type":"string","description":"Earliest credential expiry date (if any)."}},"required":["type","passed","evaluatedAt","evidence"],"description":"Response from predicate query evaluation."}}}}
```

## The ProjectionEvaluateResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"ProjectionEvaluateResponse":{"type":"object","properties":{"type":{"const":"projection"},"data":{"$ref":"#/components/schemas/Recordstringunknown","description":"Extracted data from the projection query."},"evaluatedAt":{"type":"string","description":"Timestamp when the query was evaluated."},"claimsUsed":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"value":{},"credentialId":{"type":"string"},"source":{"type":"string"}},"required":["path","value"]},"description":"Claims used during evaluation."},"expiresAt":{"type":"string","description":"Earliest credential expiry date (if any)."}},"required":["type","data","evaluatedAt","claimsUsed"],"description":"Response from projection query evaluation."},"Recordstringunknown":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{}}}}}
```

## The QueryEvaluateRequest object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"QueryEvaluateRequest":{"type":"object","properties":{"query":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"},{"type":"object","properties":{"projections":{"type":"array","items":{"type":"object","properties":{"claim":{"type":"string"},"lens":{"oneOf":[{"const":"at"},{"const":"pluck"},{"const":"pick"}]}},"required":["claim","lens"]}}},"required":["projections"]}],"description":"The query to evaluate. Can be a simple check or compound policy."}},"required":["query"],"description":"Request body for query evaluation."},"__type.o12":{"type":"object","properties":{"policy":{"$ref":"#/components/schemas/PredicatePolicy"}},"required":["policy"]},"PredicatePolicy":{"type":"object","properties":{"allOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"anyOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"not":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"required":[],"description":"Forward declaration for recursive predicate policy schema."}}}}
```

## The \_\_type.o12 object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"__type.o12":{"type":"object","properties":{"policy":{"$ref":"#/components/schemas/PredicatePolicy"}},"required":["policy"]},"PredicatePolicy":{"type":"object","properties":{"allOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"anyOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"not":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"required":[],"description":"Forward declaration for recursive predicate policy schema."}}}}
```

## The PredicatePolicy object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"PredicatePolicy":{"type":"object","properties":{"allOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"anyOf":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"not":{"oneOf":[{"type":"object","properties":{"check":{"type":"object","properties":{"claim":{"type":"string"},"operator":{"oneOf":[{"const":"startsWith"},{"const":"=="},{"const":"!="},{"const":">"},{"const":">="},{"const":"<"},{"const":"<="},{"const":"in"},{"const":"notIn"},{"const":"contains"},{"const":"isDefined"},{"const":"matchRegex"}]},"value":{}},"required":["claim","operator"]}},"required":["check"]},{"$ref":"#/components/schemas/__type.o12"}]}},"required":[],"description":"Forward declaration for recursive predicate policy schema."},"__type.o12":{"type":"object","properties":{"policy":{"$ref":"#/components/schemas/PredicatePolicy"}},"required":["policy"]}}}}
```

## The AuthorizationsResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizationsResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AuthorizationUpdate"}},"last_modified":{"type":"string"},"has_more":{"type":"boolean"}},"required":["items"]},"AuthorizationUpdate":{"type":"object","properties":{"authorization_id":{"type":"string"},"organization_id":{"type":"string"},"app_scoped_user_id":{"type":"string"},"status":{"oneOf":[{"const":"revoked"},{"const":"active"}]},"updated_at":{"type":"string"}},"required":["authorization_id","organization_id","app_scoped_user_id","status","updated_at"]}}}}
```

## The AuthorizationUpdate object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizationUpdate":{"type":"object","properties":{"authorization_id":{"type":"string"},"organization_id":{"type":"string"},"app_scoped_user_id":{"type":"string"},"status":{"oneOf":[{"const":"revoked"},{"const":"active"}]},"updated_at":{"type":"string"}},"required":["authorization_id","organization_id","app_scoped_user_id","status","updated_at"]}}}}
```

## The AuthorizationsQuery object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"AuthorizationsQuery":{"type":"object","properties":{"status":{"oneOf":[{"const":"revoked"},{"const":"active"}]},"updated_since":{"type":"string"},"limit":{"type":"number"}},"required":[]}}}}
```

## The HpConfiguration object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HpConfiguration":{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"revoke_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"jwks_uri":{"type":"string"},"presets_endpoint":{"type":"string"},"presets_batch_endpoint":{"type":"string"},"credentials_endpoint":{"type":"string"},"authorizations_endpoint":{"type":"string"},"hp_configuration_endpoint":{"type":"string"},"scopes_supported":{"type":"array","items":{"type":"string"}},"scopes_catalog":{"type":"array","items":{"$ref":"#/components/schemas/HpScopeDescriptor"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}},"response_types_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"claim_types_supported":{"type":"array","items":{"type":"string"}},"claims_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"presets_available":{"type":"array","items":{"$ref":"#/components/schemas/HpConfigurationPreset"}},"rate_limit_default":{"type":"number"},"rate_limit_unit":{"type":"string"}},"required":["issuer","authorization_endpoint","token_endpoint","revoke_endpoint","userinfo_endpoint","jwks_uri","presets_endpoint","presets_batch_endpoint","credentials_endpoint","authorizations_endpoint","hp_configuration_endpoint","scopes_supported","scopes_catalog","grant_types_supported","code_challenge_methods_supported","response_types_supported","token_endpoint_auth_methods_supported","subject_types_supported","claim_types_supported","claims_supported","id_token_signing_alg_values_supported","presets_available","rate_limit_default","rate_limit_unit"]},"HpScopeDescriptor":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"implied_scopes":{"type":"array","items":{"type":"string"}},"is_default":{"type":"boolean"}},"required":["id","display_name","description","category"]},"HpConfigurationPreset":{"type":"object","properties":{"name":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"scope":{"type":"string"},"type":{"oneOf":[{"const":"string"},{"const":"number"},{"const":"boolean"},{"const":"date"},{"const":"datetime"},{"const":"integer"},{"const":"array"},{"const":"enum"},{"const":"bundled"}]},"description":{"type":"string"},"consent_text":{"type":"string"}},"required":["name","scope","type","description","consent_text"]}}}}
```

## The HpScopeDescriptor object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HpScopeDescriptor":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"implied_scopes":{"type":"array","items":{"type":"string"}},"is_default":{"type":"boolean"}},"required":["id","display_name","description","category"]}}}}
```

## The HpConfigurationPreset object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HpConfigurationPreset":{"type":"object","properties":{"name":{"oneOf":[{"const":"humanity_uuid"},{"const":"humanity_score"},{"const":"is_human"},{"const":"country_of_residence"},{"const":"age"},{"const":"date_of_birth"},{"const":"residency_region"},{"const":"age_over_18"},{"const":"nationality"},{"const":"email"},{"const":"phone"},{"const":"age_over_21"},{"const":"social_accounts"},{"const":"wallet_address"},{"const":"primary_wallet_address"},{"const":"address_postal_code"},{"const":"legal_name"},{"const":"address_full"},{"const":"document_country"},{"const":"document_expiry_date"},{"const":"document_number"},{"const":"net_worth_total"},{"const":"bank_balance_total"},{"const":"loan_balance_total"},{"const":"kyc_passed"},{"const":"kyc_last_updated_at"},{"const":"net_worth_above_10k"},{"const":"net_worth_above_100k"},{"const":"google_connected"},{"const":"linkedin_connected"},{"const":"facebook_connected"},{"const":"twitter_connected"},{"const":"discord_connected"},{"const":"github_connected"},{"const":"telegram_connected"},{"const":"palm_verified"},{"const":"humanity_user"},{"const":"proof_of_assets"},{"const":"proof_of_investments"},{"const":"proof_of_mortgage"},{"const":"proof_of_residency"},{"const":"proof_of_retirement"}]},"scope":{"type":"string"},"type":{"oneOf":[{"const":"string"},{"const":"number"},{"const":"boolean"},{"const":"date"},{"const":"datetime"},{"const":"integer"},{"const":"array"},{"const":"enum"},{"const":"bundled"}]},"description":{"type":"string"},"consent_text":{"type":"string"}},"required":["name","scope","type","description","consent_text"]}}}}
```

## The OpenIdConfiguration object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"OpenIdConfiguration":{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"jwks_uri":{"type":"string"},"response_types_supported":{"type":"array","items":{"type":"string"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"scopes_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"claim_types_supported":{"type":"array","items":{"type":"string"}},"claims_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"revocation_endpoint":{"type":"string"},"revocation_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}}},"required":["issuer","authorization_endpoint","token_endpoint","userinfo_endpoint","jwks_uri","response_types_supported","grant_types_supported","scopes_supported","code_challenge_methods_supported","token_endpoint_auth_methods_supported","subject_types_supported","claim_types_supported","claims_supported","id_token_signing_alg_values_supported","revocation_endpoint"]}}}}
```

## The JsonWebKeySet object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"JsonWebKeySet":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/JwksKey"}}},"required":["keys"]},"JwksKey":{"type":"object","properties":{"kty":{"type":"string"},"use":{"const":"sig"},"kid":{"type":"string"},"alg":{"type":"string"},"n":{"type":"string"},"e":{"type":"string"}},"required":["kty","use","kid","alg","n","e"]}}}}
```

## The JwksKey object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"JwksKey":{"type":"object","properties":{"kty":{"type":"string"},"use":{"const":"sig"},"kid":{"type":"string"},"alg":{"type":"string"},"n":{"type":"string"},"e":{"type":"string"}},"required":["kty","use","kid","alg","n","e"]}}}}
```

## The HealthLivenessResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HealthLivenessResponse":{"type":"object","properties":{"status":{"const":"ok"},"uptime":{"type":"number"},"version":{"type":"string"},"commit":{"oneOf":[{"type":"null"},{"type":"string"}]},"timestamp":{"type":"string"}},"required":["status","uptime","version","commit","timestamp"]}}}}
```

## The HealthReadinessResponse object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HealthReadinessResponse":{"type":"object","properties":{"status":{"oneOf":[{"const":"ready"},{"const":"not_ready"}]},"checks":{"type":"array","items":{"$ref":"#/components/schemas/HealthReadinessCheck"}}},"required":["status","checks"]},"HealthReadinessCheck":{"type":"object","properties":{"name":{"type":"string"},"ok":{"type":"boolean"},"details":{"$ref":"#/components/schemas/Recordstringstringnumberbooleannull"}},"required":["name","ok"]},"Recordstringstringnumberbooleannull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"}]}}}}}
```

## The HealthReadinessCheck object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"HealthReadinessCheck":{"type":"object","properties":{"name":{"type":"string"},"ok":{"type":"boolean"},"details":{"$ref":"#/components/schemas/Recordstringstringnumberbooleannull"}},"required":["name","ok"]},"Recordstringstringnumberbooleannull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"}]}}}}}
```

## The Recordstringstringnumberbooleannull object

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"0.1.0"},"components":{"schemas":{"Recordstringstringnumberbooleannull":{"type":"object","properties":{},"required":[],"description":"Construct a type with a set of properties K of type T","additionalProperties":{"oneOf":[{"type":"null"},{"type":"string"},{"type":"number"},{"type":"boolean"}]}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.humanity.org/api-reference/reference/models.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.