---
updatedAt: 2026-08-03T17:15:53.000Z
---

# Token Detail

This process retrieves the access permissions granted by sellers to applications in the context of OAuth 2.0. The scope encompasses various API categories, each with its respective access levels, for example Reports: View Only, Item: Full Access, etc.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "title": "Authentication & Authorization Management",
    "description": "The Walmart Marketplace APIs use OAuth for token-based authentication and authorization.<Br /> We also introduced OAuth 2.0 for solution providers to enable new authorizations using authorization code grant type. Sellers can now connect with solution provider apps seamlessly through this new Walmart's OAuth 2.0 user experience. Refer to the [Guide section](/doc/us/mp/us-mp-auth2/#606) for comprehensive instructions. Existing seller connections using the previous authorization method will remain operational."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "paths": {
    "/v3/token/detail": {
      "get": {
        "tags": [
          "Authorization"
        ],
        "summary": "Token Detail",
        "description": "This process retrieves the access permissions granted by sellers to applications in the context of OAuth 2.0. The scope encompasses various API categories, each with its respective access levels, for example Reports: View Only, Item: Full Access, etc.",
        "externalDocs": {
          "description": "View Guide",
          "url": "/doc/us/mp/us-mp-auth2/#606"
        },
        "operationId": "getTokenDetail",
        "parameters": [
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "The access token retrieved in the Token API call",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Walmart Service Name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "expire_at",
                    "is_channel_match",
                    "is_valid",
                    "issued_at",
                    "scopes"
                  ],
                  "type": "object",
                  "properties": {
                    "scopes": {
                      "type": "object",
                      "properties": {
                        "reports": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "item": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "shipping": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "price": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "lagtime": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "feeds": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "returns": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "orders": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "rules": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "inventory": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        },
                        "content": {
                          "type": "string",
                          "enum": [
                            "full_access",
                            "view_only",
                            "no_access"
                          ]
                        }
                      },
                      "description": "The API categories with their corresponding access levels",
                      "default": "{“reports”: “view_only”}"
                    },
                    "expire_at": {
                      "type": "string",
                      "description": "The timestamp when the token expires",
                      "default": "1560973098000"
                    },
                    "issued_at": {
                      "type": "string",
                      "description": "The timestamp when the token is issued",
                      "default": "1560973098000"
                    },
                    "is_valid": {
                      "type": "boolean",
                      "description": "Whether the token is valid; boolean value of true or false",
                      "default": true
                    },
                    "is_channel_match": {
                      "type": "boolean",
                      "description": "Whether the keys Seller used are correctly associated",
                      "default": true
                    }
                  }
                },
                "example": {
                  "expire_at": "1560973098000",
                  "issued_at": "1560972198000",
                  "is_valid": true,
                  "scopes": {
                    "item": "full_access",
                    "price": "full_access",
                    "feeds": "view_only",
                    "returns": "full_access",
                    "orders": "full_access",
                    "inventory": "full_access"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```