---
title: "MessageRelations.get"
method: GET
path: "/entities/MessageRelations/{id}"
tags: ["Message"]
---

# MessageRelations.get

`GET /entities/MessageRelations/{id}`

## Request

- Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id`
- URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/MessageRelations/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/coevera/apis/coevera-crm-api/docs/entities/MessageRelations/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the MessageRelation record with the given id.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `expand` string

## Response `200`

The MessageRelation record.

- object
  - `success` boolean: True when the request succeeded; false on error.
  - `data` MessageRelation: Link between a message (email or memo) and a record such as an account, contact, lead or opportunity.
    - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
    - `id` string, uuid, required: Unique identifier of entity.
    - `is_deleted` boolean: Specifies if the entity is considered deleted.
    - `modified` string, date-time: Last modification time.
    - `created` string, date-time: Creation time.
    - `account` string, uri: Account the message is linked to, or empty when not linked to an account. Related Account record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Account' for its fields.
    - `contact` string, uri: Contact the message is linked to, or empty when not linked to a contact. Related Contact record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Contact' for its fields.
    - `custom_entity` string, uri: Custom entity record the message is linked to, or empty when not linked. Related CustomEntity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'CustomEntity' for its fields.
    - `lead` string, uri: Lead the message is linked to. Set when lead_oppty_id resolves to a Lead; otherwise empty. Related Lead record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Lead' for its fields.
    - `oppty` string, uri: Opportunity the message is linked to. Set when lead_oppty_id resolves to an Opportunity; otherwise empty. Related Opportunity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Opportunity' for its fields.
    - `email` string, uri: Email side of the link. Set when message_id resolves to an Email; otherwise empty. Related Email record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Email' for its fields.
    - `memo` string, uri: Memo side of the link. Set when message_id resolves to a Memo; otherwise empty. Related Memo record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Memo' for its fields.
    - `project` string, uri: Project the message is linked to, or empty when not linked. Related Project record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Project' for its fields.
    - `quote` string, uri: Quote the message is linked to, or empty when not linked. Related Quote record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Quote' for its fields.
    - `account_id` string, uuid: Id of the linked account.
    - `contact_id` string, uuid: Id of the linked contact.
    - `custom_entity_id` string, uuid: Id of the linked custom entity record.
    - `lead_oppty_id` string, uuid: Id of the lead or opportunity the message is linked to, or empty when not linked.
    - `message_id` string, uuid, required: Id of the email or memo on this link.
    - `project_id` string, uuid: Id of the linked project.
    - `quote_id` string, uuid: Id of the linked quote.
    - `revision` integer: Revision when entity was lastly changed.

## Other responses

- `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`.
- `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED).
- `404`: No such record or entity (code 143 ERROR_NO_ENTITY, or 2006 ERROR_UNKNOWN_TYPE).
- `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry.
- `500`: Unexpected server error (code 1000, ERROR_UNKNOWN).

---

[API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)