Skip to content
Northwestern Laravel Starter

Get an access token

GET
/api/v1/me/tokens/{token}
 
curl --request GET \
  --url https://example.com/api/v1/me/tokens/42 \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
token
required
integer format: int64
Example 
42

The ID of the access token.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Access token details.

Media type application/json
object
data
required
object
id
required
integer format: int64
name
required
string
status
required

Operational status of the token, derived from revocation and expiration timestamps.

string
Allowed values: active expired revoked
last_used_at

When this token was last used (null if never used).

string format: date-time
nullable
usage_count
required
integer
expires_at

When this token expires. Null means the token does not expire.

string format: date-time
nullable
created_at
required
string format: date-time
allowed_ips

Optional list of IPs or CIDR ranges allowed to use this token.

Array<string>
nullable
Example 
{
  "data": {
    "id": 23145,
    "name": "CI Deployments",
    "status": "active",
    "last_used_at": "2024-04-11T14:35:05Z",
    "usage_count": 12,
    "expires_at": "2024-12-31T06:00:00Z",
    "created_at": "2024-03-01T18:11:00Z",
    "allowed_ips": [
      "10.0.0.0/24",
      "203.0.113.12"
    ]
  }
}

401

Section titled “401 ”

Missing or invalid bearer token.

Media type application/json

Standard RFC 9457 problem details envelope.

object
type
required

RFC 9457 compliant problem details response builder.

string format: uri
title
required
string
status
required
integer
detail
string
nullable
instance
required
string format: uri-reference
trace_id

Unique identifier for the API request (if available).

string
nullable
Example 
{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication failed",
  "instance": "/api/v1/me",
  "trace_id": "b4f5aa7a-1470-4d92-8d3c-98e7c7de9f5f"
}

404

Section titled “404 ”

Access token not found.

Media type application/json

Standard RFC 9457 problem details envelope.

object
type
required

RFC 9457 compliant problem details response builder.

string format: uri
title
required
string
status
required
integer
detail
string
nullable
instance
required
string format: uri-reference
trace_id

Unique identifier for the API request (if available).

string
nullable
Example 
{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication failed",
  "instance": "/api/v1/me",
  "trace_id": "b4f5aa7a-1470-4d92-8d3c-98e7c7de9f5f"
}