---
title: "Gets a list of Relationships"
method: GET
path: "/Relationships"
tags: ["Relationships"]
---

# Gets a list of Relationships

`GET /Relationships`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Relationships`
- Auth: none declared. Required headers: `Authorization`

This read only endpoint returns a list of the relationships that have been defined for the Insightly instance.            Relationships enable users to define how one Insightly object is related to another.            For example: contact A is a customer of contact B. The API only supports read access to relationships, to create or update            relationships, you'll need to do so via the web app.

## Query parameters

- `skip` integer
- `top` integer
- `count_total` boolean

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- object[]
  - `RELATIONSHIP_ID` integer
  - `FORWARD_TITLE` string
  - `FORWARD` string
  - `REVERSE_TITLE` string
  - `REVERSE` string
  - `FOR_CONTACTS` boolean
  - `FOR_ORGANISATIONS` boolean

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Authentication failed.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)