POST
/
entities
/
{entityId}
/
shareholders
Create a new shareholder for an entity
curl --request POST \
  --url https://api.syntage.com/entities/{entityId}/shareholders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "relationType": "shareholders",
  "name": "JUAN MANUEL PEREZ GONZALEZ",
  "rfc": "PEIC211118IS0",
  "shares": 1500.5
}'
{
  "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678",
  "@type": "Shareholder",
  "id": "91ab5678-1234-5678-9abc-def012345678",
  "name": "JUAN MANUEL PEREZ GONZALEZ",
  "type": "physical",
  "rfc": "PEIC211118IS0",
  "relations": [
    {
      "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678/relations/82cd9012-3456-7890-abcd-ef1234567890",
      "@type": "ShareholderRelation",
      "id": "82cd9012-3456-7890-abcd-ef1234567890",
      "link": "/entities/91ab5678-1234-5678-9abc-def012345678",
      "shareholder": {},
      "relationType": "shareholders",
      "sources": [
        {
          "@id": "/shareholders/91ab5678-1234-5678-9abc-def012345678/relations/82cd9012-3456-7890-abcd-ef1234567890/sources/73de0123-4567-8901-bcde-f23456789012",
          "@type": "ShareholderRelationsSource",
          "id": "73de0123-4567-8901-bcde-f23456789012",
          "relation": {},
          "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"
        }
      ],
      "shares": 1500.5,
      "totalShares": 10000,
      "ownership": 0.15,
      "createdAt": "2020-01-01T12:15:00.000Z",
      "updatedAt": "2020-01-01T12:15:00.000Z"
    }
  ],
  "entity": "/entities/91ab5678-1234-5678-9abc-def012345678",
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

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

Path Parameters

​
entityId
string<uuid>
required

Body

application/json
​
relationType
enum<string>
required

Represents the relationship between a shareholder and an entity:

  • shareholders: The entity's shareholders
  • shareholder_of: Entities that this shareholder owns shares in
Available options:
shareholders,
shareholder_of
Example:

"shareholders"

​
name
string
required

The name of the shareholder

Example:

"JUAN MANUEL PEREZ GONZALEZ"

​
shares
number
required

The number of shares owned by the shareholder

Required range: x >= 0.01
Example:

1500.5

​
rfc
string

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

Response

Shareholder created successfully

​
id
string<uuid>
required
Example:

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

​
name
string
required

Shareholder name

Example:

"JUAN MANUEL PEREZ GONZALEZ"

​
type
enum<string>
required

Shareholder type

Available options:
physical,
legal,
unknown
Example:

"physical"

​
rfc
string
required

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

​
relations
object[]
required

Shareholder relations with entities

​
entity
string<iri-reference> | null
required

Associated entity

Example:

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

​
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>

Shareholder IRI reference

Example:

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

​
@type
string
default:Shareholder