AWorld APIs are in a pre-alpha stage and are being updated frequently. For integration inquiries or technical information, please contact us at server@aworld.org.

AWorld API

Get OAuth2 Access Token

POST

https://auth.aworld.cloud/oauth2/token

Authentication

Obtain an access token using OAuth2 Client Credentials flow. Use the returned access_token as Bearer token in the Authorization header for all API requests.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://auth.aworld.cloud/oauth2/token' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=your_client_id' \
--data-urlencode 'client_secret=your_client_secret'

Response Example

{
    "access_token": "string",
    "token_type": "Bearer",
    "expires_in": 0
}

Request

Body Params application/x-www-form-urlencoded

grant_type

enum<string>

required

OAuth2 grant type

Allowed value:

client_credentials

Example:

client_credentials

client_id

string

required

Your OAuth2 client ID

Example:

your_client_id

client_secret

string

required

Your OAuth2 client secret

Example:

your_client_secret

Responses

🟢200OK

application/json

Access token obtained successfully

Body

access_token

string

optional

The access token to use in API requests

token_type

string

optional

Token type

Example:

Bearer

expires_in

integer

optional

Token expiration time in seconds

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-06-26 11:34:00

List activities