Skip to main content
PATCH
/
shareholders
/
{shareholderId}
/
relations
/
{relationId}
Update a shareholder relation
curl --request PATCH \
  --url https://api.syntage.com/shareholders/{shareholderId}/relations/{relationId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "shares": 1500.5
}
'
{
  "id": "82cd9012-3456-7890-abcd-ef1234567890",
  "link": "/entities/91ab5678-1234-5678-9abc-def012345678",
  "shareholder": {
    "id": "91ab5678-1234-5678-9abc-def012345678",
    "name": "JUAN MANUEL PEREZ GONZALEZ",
    "type": "physical",
    "rfc": "PEIC211118IS0",
    "relations": "<array>",
    "entity": "/entities/91ab5678-1234-5678-9abc-def012345678",
    "createdAt": "2020-01-01T12:15:00.000Z",
    "updatedAt": "2020-01-01T12:15:00.000Z",
    "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678",
    "@type": "Shareholder"
  },
  "relationType": "shareholders",
  "sources": [
    {
      "id": "73de0123-4567-8901-bcde-f23456789012",
      "relation": "<unknown>",
      "shareholder": {
        "id": "91ab5678-1234-5678-9abc-def012345678",
        "name": "JUAN MANUEL PEREZ GONZALEZ",
        "type": "physical",
        "rfc": "PEIC211118IS0",
        "relations": "<array>",
        "entity": "/entities/91ab5678-1234-5678-9abc-def012345678",
        "createdAt": "2020-01-01T12:15:00.000Z",
        "updatedAt": "2020-01-01T12:15:00.000Z",
        "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678",
        "@type": "Shareholder"
      },
      "sourceName": "manual",
      "sourceId": "64ef1234-5678-9012-cdef-345678901234",
      "shares": 1500.5,
      "createdAt": "2020-01-01T12:15:00.000Z",
      "updatedAt": "2020-01-01T12:15:00.000Z",
      "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678/relations/82cd9012-3456-7890-abcd-ef1234567890/sources/73de0123-4567-8901-bcde-f23456789012",
      "@type": "ShareholderRelationsSource"
    }
  ],
  "shares": 1500.5,
  "totalShares": 10000,
  "ownership": 0.15,
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z",
  "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678/relations/82cd9012-3456-7890-abcd-ef1234567890",
  "@type": "ShareholderRelation"
}

Authorizations

​
X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

​
shareholderId
string<uuid>
required

The shareholder ID

​
relationId
string<uuid>
required

The relation ID

Body

application/json
​
shares
number<float>
required

Updated number of shares represented by the relation

Required range: x >= 0.01
Example:

1500.5

Response

Shareholder Relation updated successfully

​
id
string<uuid>
required

Unique shareholder relation ID

Example:

"82cd9012-3456-7890-abcd-ef1234567890"

​
link
string<iri-reference>
required

Entity connected to this shareholder relation

Example:

"/entities/91ab5678-1234-5678-9abc-def012345678"

​
shareholder
object
required

Shareholder connected by this relation

​
relationType
enum<string>
required

Direction of the ownership relation between the shareholder and entity

Available options:
shareholders,
shareholder_of
Example:

"shareholders"

​
sources
object[]
required

Sources that support this shareholder relation

​
shares
number<float>
required

Number of shares represented by this relation

Example:

1500.5

​
totalShares
number<float> | null
required

Total number of shares in the company, when known

Example:

10000

​
ownership
number<float> | null
required

Ownership ratio as a decimal value, for example 0.15 means 15%

Example:

0.15

​
createdAt
string
required

Date and time the resource was created

Example:

"2020-01-01T12:15:00.000Z"

​
updatedAt
string
required

Date and time the resource was last updated

Example:

"2020-01-01T12:15:00.000Z"

​
@id
string<iri-reference>

ShareholderRelation IRI reference

Example:

"/shareholders/91ab5678-1234-5678-9abc-def012345678/relations/82cd9012-3456-7890-abcd-ef1234567890"

​
@type
string
default:ShareholderRelation