Variant Group Amplitude API Proxy Contractor Guide

Use this proxy instead of calling Amplitude directly. It allows access only to specific endpoints (scoped per contractor key).

How to call

Replace Amplitude's base URL with the proxy base URL (this domain). Keep the same path and query params.

  • Set header: Authorization: Bearer <proxyKey> instead basic auth and Amplitudes API keys.
  • The proxy rewrites authorization internally and forwards to Amplitude.

Currently supported endpoints

  • GET|HEAD /api/2/usersearch (Dashboard REST)
  • GET|HEAD /api/2/useractivity (Dashboard REST)
  • GET|HEAD /v1/userprofile (User Profile API)

Any other path returns 401.

Examples (curl)

User Search

curl -i \
  -H "Authorization: Bearer <proxyKey>" \
  "__PROXY_ORIGIN__/api/2/usersearch?user_id=123"

User Activity

curl -i \
  -H "Authorization: Bearer <proxyKey>" \
  "__PROXY_ORIGIN__/api/2/useractivity?user_id=123"

User Profile

curl -i \
  -H "Authorization: Bearer <proxyKey>" \
  "__PROXY_ORIGIN__/v1/userprofile?user_id=123"

Common errors

  • 401: missing/invalid proxy key, endpoint not in your scope, or non-read-only method
  • 502: upstream Amplitude request failed at the proxy

If you need access to more endpoints, ask the project owner to add the required scope(s) for your key.