---
updatedAt: 2026-08-03T16:17:26.000Z
agentTools:
  projectIndex: https://apidocs.taxbit.com/llms.txt
---

# Get an Account Owner Scoped Bearer Token

This token serves as the authorization mechanism enabling you to submit and access Tax Documentation on behalf of the account owner. It is specifically designed for use with Account Owner and Tax Documentation endpoints and is primarily employed by customers using the Taxbit W8/W9 solution.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v1/oauth/account-owner-token": {
      "post": {
        "description": "This token serves as the authorization mechanism enabling you to submit and access Tax Documentation on behalf of the account owner. It is specifically designed for use with Account Owner and Tax Documentation endpoints and is primarily employed by customers using the Taxbit W8/W9 solution.",
        "operationId": "EmbeddedOAuthController_getAccountOwnerToken",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "client_id": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_id.",
                        "example": "<client_id>"
                      },
                      "client_secret": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_secret.",
                        "example": "<client_secret>"
                      },
                      "grant_type": {
                        "type": "string",
                        "description": "OAuth 2.0 grant_type. The only supported value at this time is client_credentials.",
                        "example": "client_credentials"
                      },
                      "id": {
                        "type": "string",
                        "description": "Your system's unique identifier for the account owner.",
                        "example": "JohnDoe864"
                      },
                      "tenant_id": {
                        "type": "string",
                        "description": "The tenant that the account owner is part of.",
                        "format": "uuid",
                        "example": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                      }
                    },
                    "required": [
                      "client_id",
                      "client_secret",
                      "grant_type",
                      "id",
                      "tenant_id"
                    ],
                    "title": "Bearer Token Request",
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "client_id": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_id.",
                        "example": "<client_id>"
                      },
                      "client_secret": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_secret.",
                        "example": "<client_secret>"
                      },
                      "grant_type": {
                        "type": "string",
                        "description": "OAuth 2.0 grant_type. The only supported value at this time is client_credentials.",
                        "example": "client_credentials"
                      },
                      "account_owner_id": {
                        "type": "string",
                        "description": "The Taxbit ID of the Account Owner.",
                        "format": "uuid",
                        "deprecated": true,
                        "example": "c0a7eae2-ad72-4bca-a690-d20b30f463b1"
                      },
                      "tenant_id": {
                        "type": "string",
                        "description": "The tenant that the account owner is part of.",
                        "format": "uuid",
                        "example": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                      }
                    },
                    "required": [
                      "client_id",
                      "client_secret",
                      "grant_type",
                      "account_owner_id",
                      "tenant_id"
                    ],
                    "title": "Bearer Token Request (Deprecated)",
                    "deprecated": true,
                    "additionalProperties": false
                  }
                ]
              },
              "examples": {
                "Bearer Token Request": {
                  "summary": "Bearer Token Request",
                  "value": {
                    "id": "JohnDoe864",
                    "client_id": "<client_id>",
                    "client_secret": "<client_secret>",
                    "grant_type": "client_credentials",
                    "tenant_id": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                  }
                },
                "Bearer Token Request (Deprecated)": {
                  "summary": "Bearer Token Request (Deprecated)",
                  "value": {
                    "account_owner_id": "c0a7eae2-ad72-4bca-a690-d20b30f463b1",
                    "client_id": "<client_id>",
                    "client_secret": "<client_secret>",
                    "grant_type": "client_credentials",
                    "tenant_id": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                  }
                }
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "client_id": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_id.",
                        "example": "<client_id>"
                      },
                      "client_secret": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_secret.",
                        "example": "<client_secret>"
                      },
                      "grant_type": {
                        "type": "string",
                        "description": "OAuth 2.0 grant_type. The only supported value at this time is client_credentials.",
                        "example": "client_credentials"
                      },
                      "id": {
                        "type": "string",
                        "description": "Your system's unique identifier for the account owner.",
                        "example": "JohnDoe864"
                      },
                      "tenant_id": {
                        "type": "string",
                        "description": "The tenant that the account owner is part of.",
                        "format": "uuid",
                        "example": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                      }
                    },
                    "required": [
                      "client_id",
                      "client_secret",
                      "grant_type",
                      "id",
                      "tenant_id"
                    ],
                    "title": "Bearer Token Request",
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "client_id": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_id.",
                        "example": "<client_id>"
                      },
                      "client_secret": {
                        "type": "string",
                        "description": "Your Taxbit authentication client_secret.",
                        "example": "<client_secret>"
                      },
                      "grant_type": {
                        "type": "string",
                        "description": "OAuth 2.0 grant_type. The only supported value at this time is client_credentials.",
                        "example": "client_credentials"
                      },
                      "account_owner_id": {
                        "type": "string",
                        "description": "The Taxbit ID of the Account Owner.",
                        "format": "uuid",
                        "deprecated": true,
                        "example": "c0a7eae2-ad72-4bca-a690-d20b30f463b1"
                      },
                      "tenant_id": {
                        "type": "string",
                        "description": "The tenant that the account owner is part of.",
                        "format": "uuid",
                        "example": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                      }
                    },
                    "required": [
                      "client_id",
                      "client_secret",
                      "grant_type",
                      "account_owner_id",
                      "tenant_id"
                    ],
                    "title": "Bearer Token Request (Deprecated)",
                    "deprecated": true,
                    "additionalProperties": false
                  }
                ]
              },
              "examples": {
                "Bearer Token Request": {
                  "summary": "Bearer Token Request",
                  "value": {
                    "id": "JohnDoe864",
                    "client_id": "<client_id>",
                    "client_secret": "<client_secret>",
                    "grant_type": "client_credentials",
                    "tenant_id": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                  }
                },
                "Bearer Token Request (Deprecated)": {
                  "summary": "Bearer Token Request (Deprecated)",
                  "value": {
                    "account_owner_id": "c0a7eae2-ad72-4bca-a690-d20b30f463b1",
                    "client_id": "<client_id>",
                    "client_secret": "<client_secret>",
                    "grant_type": "client_credentials",
                    "tenant_id": "8d0bd177-dd48-4bea-b89e-c4ce038375e7"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Account owner token",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1qRXpRamxETmpRd01ESkVORU16TVVFd1FUWTRRamRDTlRaRk5VSTFRVVV5TlVGQlJUQTNPUSJ9...",
                      "expires_in": 3600,
                      "token_type": "Bearer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "message": "Invalid Request"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "message": "Unauthorized Error"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "message": "Forbidden Error"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests"
          }
        },
        "security": [
          {}
        ],
        "summary": "Get an Account Owner Scoped Bearer Token",
        "tags": [
          "Auth Token"
        ]
      }
    }
  },
  "info": {
    "title": "Embedded API",
    "description": "",
    "version": "1.2.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.multi1.enterprise.taxbit.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "TokenResponseDto": {
        "type": "object",
        "properties": {
          "access_token": {
            "type": "string",
            "description": "Bearer token to use on behalf of an Account Owner to access and modify their Tax Documentation.",
            "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1qRXpRamxETmpRd01ESkVORU16TVVFd1FUWTRRamRDTlRaRk5VSTFRVVV5TlVGQlJUQTNPUSJ9..."
          },
          "expires_in": {
            "type": "integer",
            "description": "Time until token expires (in seconds).",
            "example": 3600
          },
          "token_type": {
            "type": "string",
            "description": "Access token type",
            "example": "Bearer"
          },
          "scope": {
            "description": "Space-delimited scopes carried by the token. The Taxbit API surface is unscoped, so the authorization server omits this field.",
            "type": "string"
          }
        },
        "required": [
          "access_token",
          "expires_in",
          "token_type"
        ],
        "title": "AuthTokenResponse",
        "additionalProperties": false
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ]
}
```