---
title: "POST /users/authorization"
method: POST
path: "/users/authorization"
tags: ["funds"]
---

# POST /users/authorization

`POST /users/authorization`

## Request

- Base URL: `https://api.outdoorsy.com/v0`
- URL: `https://api.outdoorsy.com/v0/users/authorization`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `API-Key`
- TypeScript: <https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/docs/users/authorization/post.ts> (a function with typed inputs; its response is checked against the schema)

Return fund authorization details for country

## Query parameters

- `APIKey` string
- `country` string
- `business_type` string
- `token` string
- `account_id` string
- `account_name` string
- `account_mask` string
- `Bui-Accept` string

## Response `200`

HTTP status code 200

- CompleteAuthorizationResponse: CompleteAuthorizationResponse is the result type of the payouts service CompleteAuthorization method.
  - `account_mask` string: The mask for the chose account.
  - `account_name` string: The name of the chosen account.
  - `authorization_id` string: The ID of the newly created Authorization object.
  - `bui` object: The BUI to display
  - `status` string: The status of the authorization. Possible values include `pending`, `active`, `expired` and `error`.

## Other responses

- `400`: Invalid input or state means you're bad
- `401`: Unauthorized error
- `default`: An unknown, unexpected error.

---

[API](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation.md) - [All operations](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/revisions/f0cf8f605ea0?raw)