Retrieve Meta measurement settings

Reads the project's Meta measurement settings: whether the install referrer key is set, how purchases reach Meta's Conversions API, when Meta last took some and the last error.

Secrets are never returned, only whether they are set. Needs project:ads:read.

Guide: Share purchases with Meta

Errors

This operation adds no error codes of its own. It can fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Meta measurement

Update Meta measurement settings PATCH

Something wrong or missing on this page? Tell us by email or on Discord.

Examples

curl -X GET "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/ads/meta-measurement/settings" \  -H "Authorization: Bearer vh_sk_..."

{  "projectId": "proj_tz4a98xxat96iws9zmbrgj3a",  "hasInstallReferrerKey": true,  "installReferrerLastError": null,  "installReferrerLastErrorAt": null,  "isConversionsEnabled": true,  "conversionsDatasetId": "1234567890123456",  "hasConversionsToken": true,  "conversionsTestEventCode": null,  "conversionsLastSentAt": "2026-03-14T09:45:03.000Z",  "conversionsLastRunAt": "2026-03-14T09:45:03.000Z",  "conversionsLastError": null,  "conversionsLastErrorAt": null,  "conversionsLastErrorKind": null,  "conversionsSkippedTotal": 3,  "conversionsRefusedInARow": 0,  "conversionsWithheld": {    "noAdDataSharing": 41,    "noMatchKey": 6,    "personGone": 1,    "reversed": 2  }}

{  "error": {    "type": "invalid_request",    "code": "string",    "message": "string",    "param": "string"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "permission_denied",    "message": "Insufficient permissions."  }}

{  "error": {    "type": "not_found",    "code": "project_not_found",    "message": "There is no project proj_tz4a98xxat96iws9zmbrgj3a, or this credential cannot use it.",    "param": "projectId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Retrieve Meta measurement settings

Errors

More in Meta measurement

Retrieve Meta measurement settings

Errors

More in Meta measurement

Authorization

Path parameters

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Retrieve Meta measurement settings

Retrieve Meta measurement settings

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`