Skip to main content
GET
/
users
/
{id}
/
links
/users/{id}/links
curl --request GET \
  --url http://localhost:8080/users/{id}/links \
  --header 'Authorization: Bearer <token>'
{
  "links": {
    "mk_eqkWN34UEoa2NxyALG8pcV": {
      "link_id": "mk_eqkWN34UEoa2NxyALG8pcV",
      "institution_id": "chase",
      "institution_name": "Chase",
      "provider": "mx",
      "state": "connected",
      "last_synced_at": "2023-02-16T09:14:11",
      "tags": [
        "user_type:admin"
      ],
      "products": {
        "accounts": {
          "refreshed_at": "2023-02-16T09:14:11",
          "last_attempted_at": "2023-02-16T09:14:11"
        },
        "identity": {
          "refreshed_at": "2023-02-16T09:14:11",
          "last_attempted_at": "2023-02-16T09:14:11",
          "settings": {
            "required": true,
            "prefetch": false
          }
        }
      }
    }
  }
}
curl -i -X GET \
  'http://localhost:8080/users/{id}/links' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'moneykit-version: 2023-02-18'

{
  "links": {
    "mk_eqkWN34UEoa2NxyALG8pcV": {
      "link_id": "mk_eqkWN34UEoa2NxyALG8pcV",
      "institution_id": "chase",
      "institution_name": "Chase",
      "provider": "mx",
      "state": "connected",
      "last_synced_at": "2023-02-16T09:14:11",
      "tags": [
        "user_type:admin"
      ],
      "products": {
        "accounts": {
          "refreshed_at": "2023-02-16T09:14:11",
          "last_attempted_at": "2023-02-16T09:14:11"
        },
        "identity": {
          "refreshed_at": "2023-02-16T09:14:11",
          "last_attempted_at": "2023-02-16T09:14:11",
          "settings": {
            "required": true,
            "prefetch": false
          }
        }
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
moneykit-version
string
default:2023-02-18

Path Parameters

​
id
string
required

The unique ID for this user. This is the same ID provided in the call to /link-session to create any link for this user.

Response

Successful Response

​
links
object
required

The set of links belonging to this user, as a dictionary of {link_id:link}.