Get current identity | Pivotal Docs

Returns the API key’s identity, organization, scopes, and rate-limit tier. Hit this first to confirm a newly-created key is wired up correctly.

Authentication

AuthorizationBearer

Send your key in the Authorization header. Keys start with pivotal_ (production) or pivotal_test_ (test mode, no side effects on integrations). Rotate keys from /admin/api-keys — old keys 401 instantly when revoked.

Response

objectenum

Allowed values:

api_keyobject

organizationobject

1	const url = 'https://my.pivotal.app/api/v1/me';
2	const options = {
3	method: 'GET',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"object": "me",
3	"api_key": {
4	"id": "api_1234567890abcdef",
5	"name": "Primary API Key",
6	"prefix": "pivotal_abc123",
7	"scopes": [
8	"read:customers",
9	"write:contacts",
10	"read:onboardings"
11	],
12	"rate_limit_tier": "standard"
13	},
14	"organization": {
15	"id": "org_9876543210fedcba",
16	"slug": "acme-corp",
17	"name": "Acme Corporation"
18	}
19	}

1	const url = 'https://my.pivotal.app/api/v1/me';
2	const options = {
3	method: 'GET',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"object": "me",
3	"api_key": {
4	"id": "api_1234567890abcdef",
5	"name": "Primary API Key",
6	"prefix": "pivotal_abc123",
7	"scopes": [
8	"read:customers",
9	"write:contacts",
10	"read:onboardings"
11	],
12	"rate_limit_tier": "standard"
13	},
14	"organization": {
15	"id": "org_9876543210fedcba",
16	"slug": "acme-corp",
17	"name": "Acme Corporation"
18	}
19	}