# Access the GovTribe API

{% hint style="warning" %}
*The GovTribe API is available on paid GovTribe accounts only and priced separately from a GovTribe Subscription, you can add the API to your account by following the instructions here: Add API Access.* 

Access to the API is controlled via[ OAuth Access Tokens](https://www.oauth.com/oauth2-servers/access-tokens/). If you're not familiar with how they work, take a moment to read up on them. Access the API's [full documentation here](https://app.swaggerhub.com/apis-docs/govtribe/api)*.*
{% endhint %}

## Access the GovTribe API

***To access the GovTribe API:***

**Step 1.**  In the **Administration Menu** in the upper right corner, select **Developer Portal**.

**Step 2.**  Click the **+ Create** link in the API Access Tokens section as you can see below:

![](https://3812838900-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCSLrBicFcHXK4b-nOy%2F-MUV0vHkP4RLiLIpt0_R%2F-MUV1ywbD3iw8usUq-T0%2FScreen%20Shot%202021-02-26%20at%203.32.09%20PM.png?alt=media\&token=ecdd5d1b-6539-478a-96e5-fccb58daa851)

**Step 3.**  The below window will pop up, enter your desired Name, accept the Terms and select **Sav**.

![](https://3812838900-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCSLrBicFcHXK4b-nOy%2F-MUV0vHkP4RLiLIpt0_R%2F-MUV21yVc60IEHDP2fQ0%2FScreen%20Shot%202021-02-26%20at%203.32.21%20PM.png?alt=media\&token=11b04318-4107-4056-a62b-547e2f7d23d3)

Note that we use[ OAuth Access Tokens](https://www.oauth.com/oauth2-servers/access-tokens/) to control access to the GovTribe API. You should send this token with each request your application makes to the GovTribe API. 

**Step 4.**  In the [GovTribe API documentation online](https://app.swaggerhub.com/apis-docs/govtribe/api/1.0.0), click the green **Authorize** button to link the Documentation's API Console to your new token. (It’s on the right side, a little way down the page.)

![](https://lh4.googleusercontent.com/Sid83-1gk_C4oYV9OOe9wG_UsLj5-hGk0hkcvtI-IGVS06bDFr0ZlgZrk_3WyNR1UkXiu_cnrwD9mM4HS2tzPs5wYwnpOWXQyQrUzgY31JFNObPgmHmWjVbW-REs4L_JJovhL6L2)

**Step 5.**  In the pop-over window, paste the token into the **Value** field, then click **Close**.

![](https://lh5.googleusercontent.com/SUCObAN-xV4URPQGvpRX4BqzjYnz5MoGZDGlKPxhWSW__MyRVXukPZGMyvDiu9iGBhE9UMOf8iWMfGxz6SguucgM3yzmMvwt-uCDB0c_P4mJI4TLxVphlcC1V5RHQuOm8r1w3dD6)

{% hint style="info" %}
The **Authorize** button should now display a closed padlock icon, meaning it’s ready to use.
{% endhint %}

## Test a Request

**Step 1.**  Access the[ GovTribe API Documentation](https://app.swaggerhub.com/apis-docs/govtribe/api).\
The first one listed in the documentation is "Get a list of Federal Agencies Resources":

![](https://lh3.googleusercontent.com/X7gEGoF08r3H4Dj0t36xpZwtGoxuQ7F07SklRFR8KrdG0jaPx6l17K7BPh32T4xPTFFACBnEYsyHzs8gqCaaiNHPow3VhXAcKiYVRNraq7_tvw8qAY15eiZ8zGLZxK7tpIOiWHQv)

**Step 2.**  Click **Try It Out** to see the request and response:

![](https://lh4.googleusercontent.com/N63CQ8vmabozvaUWIIRVVelX4wpFzDP2Zo1OLwNIwIOuu7GVqusQuR1qBHIf0NJGlZ6gRqflgrs9TmWF6a5z_vGOK-UsdkR16DbxP2tz7_MjqI4OLTm8l9HgTH2hCwYPv7SXcdDv)

## Need Help?  Find a Bug?[ ](https://github.com/GovTribe/api)

Questions? [@govtribe](https://twitter.com/govtribe) or <help@govtribe.com>\
Bugs? [GovTribe/api](https://github.com/GovTribe/api)