How to hit the Bitbucket Cloud API

Bitbucket Cloud's API lives at https://api.bitbucket.org/2.0. Public repositories can be read without auth.

Authentication

Use Basic auth with your Atlassian account email and an API token — curl's -u, PostTaco's Auth tab. Create the token at id.atlassian.com.

Full reference: https://developer.atlassian.com/cloud/bitbucket/rest/intro/

Get a public repository

No auth needed.

curl https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express
Run in PostTaco
Example response (trimmed)
{
  "type": "repository",
  "full_name": "atlassian/atlassian-connect-express",
  "links": {
    "self": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express"
    },
    "html": {
      "href": "https://bitbucket.org/atlassian/atlassian-connect-express"
    },
    "avatar": {
      "href": "https://bytebucket.org/ravatar/%7B47b154f6-a82d-4e03-99ce-44fb75b4827c%7D?ts=138914"
    },
    "pullrequests": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/pullrequests"
    },
    "commits": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/commits"
    },
    "forks": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/forks"
    },
    "watchers": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/watchers"
    },
    "branches": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/refs/branches"
    },
    "tags": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/refs/tags"
    },
    "downloads": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/downloads"
    },
    "source": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/src"
    },
    "clone": [
      {
        "name": "https",
        "href": "https://bitbucket.org/atlassian/atlassian-connect-express.git"
      },
      {
        "name": "ssh",
        "href": "[email protected]:atlassian/atlassian-connect-express.git"
      }
    ],
    "hooks": {
      "href": "https://api.bitbucket.org/2.0/repositories/atlassian/atlassian-connect-express/hooks"
    }
  },
  "name": "atlassian-connect-express",
  "slug": "atlassian-connect-express",
  "description": "atlassian-connect-express (ACE) is a toolkit for creating Atlassian Connect based apps with Node.js. Atlassian Connect is a distributed component model for creating Atlassian apps. Apps built with Atlassian Connect extend Atlassian products over standard web protocols and APIs.",
  "scm": "git",
  "website": "",
  "owner": {
    "display_name": "Atlassian",
    "links": {
      "self": {
        "href": "https://api.bitbucket.org/2.0/workspaces/%7B02b941e3-cfaa-40f9-9a58-cec53e20bdc3%7D"
      },
      "avatar": {
        "href": "https://bitbucket.org/account/atlassian/avatar/"
      },
      "html": {
        "href": "https://bitbucket.org/%7B02b941e3-cfaa-40f9-9a58-cec53e20bdc3%7D/"
      }
    },
    "type": "team",
    "uuid": "{02b941e3-cfaa-40f9-9a58-cec53e20bdc3}",
    "username": "atlassian"
  },
  "workspace": {
    "type": "workspace",
    "uuid": "{02b941e3-cfaa-40f9-9a58-cec53e20bdc3}",
    "name": "Atlassian",
    "slug": "atlassian",
    "links": {
      "avatar": {
        "href": "https://bitbucket.org/workspaces/atlassian/avatar/?ts=1760749566"
      },
      "html": {
        "href": "https://bitbucket.org/atlassian/"
      },
      "self": {
        "href": "https://api.bitbucket.org/2.0/workspaces/atlassian"
      }
    }
  },
  "is_private": false,
  "project": {
    "type": "project",
    "key": "AC",
    "uuid": "{cc445f42-b2f8-4d69-bfd1-4e0047966e87}",
    "name": "Atlassian Connect",
    "links": {
      "self": {
        "href": "https://api.bitbucket.org/2.0/workspaces/atlassian/projects/AC"
      },
      "html": {
        "href": "https://bitbucket.org/atlassian/workspace/projects/AC"
      },
      "avatar": {
        "href": "https://bitbucket.org/atlassian/workspace/projects/AC/avatar/32?ts=1450914087"
      }
    }
  },
  "fork_policy": "allow_forks",
  "created_on": "2013-07-24T23:40:13.276392+00:00",
  "updated_on": "2026-09-22T14:56:49.170055+00:00"
}

Current user

curl https://api.bitbucket.org/2.0/user \
  -u {{BITBUCKET_EMAIL}}:{{BITBUCKET_API_TOKEN}}
Run in PostTaco

Open pull requests

curl "https://api.bitbucket.org/2.0/repositories/{{WORKSPACE}}/{{REPO}}/pullrequests?state=OPEN" \
  -u {{BITBUCKET_EMAIL}}:{{BITBUCKET_API_TOKEN}}
Run in PostTaco