Get entity informations

GET /companies/:companyID/entities/:entityID

Request

Path Parameters

entityID uuidrequired

Query Parameters

reference_type string

Possible values: [customer, oldCustomer, prospect, relation]

Responses

success - entity informations

application/json

Schema
Example (from schema)

Schema

id stringrequired

name stringrequired

created stringnullable

The date of creation of the customer

updated stringrequired

The date of the last update of the customer

general

object

nullable

entryDateIntoRelationship

object

anyOf

MOD1
MOD2

string

originCustomerRelationship stringnullable

Possible values: [incomingCall, outgoingCall, affiliate, eContact, eContactTmp, businessCapital, boogeLeads, prospecting, portfolioBuyout, aktifPlusMeeting, ifbMeeting, recommendation, signatureClient, meetingTmp, meeting, socialNetwork, retiree, tradeShows, website, dinner, spontaneousSolicitation, internalFollowUp, guardianshipAssociation, relationship, prescriber, formerClient, other]

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting

object

anyOf

MOD1
MOD2

string

entryIntoRelationshipNote stringnullable

gender stringnullable

Possible values: [male, female]

Default value: male

name stringnullable

lastName stringnullable

firstName stringnullable

birthDate

object

anyOf

MOD1
MOD2

string

birthZipCode stringnullable

birthRegion stringnullable

birthCity stringnullable

birthCountry stringnullable

birthName stringnullable

deathDate

object

anyOf

MOD1
MOD2

string

familySituation stringnullable

Possible values: [none, inARelationship, civilUnion, remarried, pendingDivorce, single, deceased, widowed, married, freeUnion, domesticPartnership, divorced, cohabitation, separated]

marriageDate

object

anyOf

MOD1
MOD2

string

nationality stringnullable

matrimonialRegime stringnullable

studiesLevel stringnullable

Possible values: [none, certificate, highSchool, bachelor, master, doctorate]

occupation stringnullable

occupationWording stringnullable

retirementAge numbernullable

annualIncome

object

anyOf

MOD1
MOD2

string

heritageOrigin stringnullable

sectorOfActivity stringnullable

dateEntryRelationship

object

anyOf

MOD1
MOD2

string

idCard stringnullable

idNumber stringnullable

issueDate

object

anyOf

MOD1
MOD2

string

authority stringnullable

expirationDate

object

anyOf

MOD1
MOD2

string

idNIF stringnullable

idMIF stringnullable

taxResidence stringnullable

customerClassificationMIF stringnullable

classificationDate

object

anyOf

MOD1
MOD2

string

pep booleannullable

usPerson booleannullable

legalCapacity stringnullable

Possible values: [noMeasure, capable, protectedUnderGuardianship, protectedUnderCuratorship, underJudicialSafeguard, unemancipatedMinor, emancipatedMinor, underJudicialConstraint, underGuardianship, absentOrOtherCapableMajor, other, judicialSafeguard, guardianship, enhancedGuardianship, custody, futureProtectionMandate, adHocAdministrator, posthumousMandate, oldStateGuardianship, oldGuardianshipManagement, oldGuardianshipArt511, oldGuardianshipArt512, privateManagementCustody, familyEmpowermentRepresentation, legalAdministration, familyEmpowermentAssistance]

tag stringnullable

referencesType stringnullable

Possible values: [customer, oldCustomer, prospect, relation]

updated

object

anyOf

MOD1
MOD2

string

homeAdress stringnullable

complement stringnullable

postalCode stringnullable

note stringnullable

city stringnullable

secondaryNationality stringnullable

country stringnullable

professionalCategory stringnullable

externalClientFileReference stringnullable

information

object

nullable

socialReason stringnullable

Possible values: non-empty

contact stringnullable

firstAddress stringnullable

secondAddress stringnullable

postalCode stringnullable

city stringnullable

country stringnullable

phone stringnullable

fax stringnullable

email emailnullable

Possible values: non-empty

website stringnullable

holdingId stringnullable

siren stringnullable

siret stringnullable

ape stringnullable

rcsNumber stringnullable

creationDate stringnullable

legalForm stringnullable

socialCapital numbernullable

headOfficeAddress stringnullable

managers

object[]

nullable

Array [

managerID stringrequired

primary booleanrequired

]

seniorAdvisor stringnullable

secondaryAdvisor stringnullable

entryDateIntoRelationship stringnullable

originCustomerRelationship stringnullable

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting stringnullable

entryIntoRelationshipNote stringnullable

ownership numbernullable

valuation numbernullable

managers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

nbManagers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

bankAccounts

object

nullable

banks string

iban string

bankAccountNumbers string

bic string

activities

object

nullable

mainActivities string

secondaryActivities string

clients string

suppliers string

competitors string

details

object

nullable

street stringnullable

zipCode stringnullable

city stringnullable

addressSupplement stringnullable

workStreet stringnullable

workZipCode stringnullable

workCity stringnullable

workAddressSupplement stringnullable

otherStreet stringnullable

otherZipCode stringnullable

otherCity stringnullable

otherAddressSupplement stringnullable

firstPhoneNumber stringnullable

secondPhoneNumber stringnullable

personalEmail emailnullable

Possible values: non-empty

otherEmail emailnullable

Possible values: non-empty

fiscalAddress stringnullable

country stringnullable

otherCountry stringnullable

workCountry stringnullable

type stringnullable

Possible values: [person, company]

assets

object[]

required

Assets (partially or fully) owned by the entity

Array [

ownership numberrequired

id uuidrequired

]

providers

object

nullable

Provider IDs associated with the entity. This field contains a mapping where each key represents a provider name and the value is an array of provider-specific IDs for this entity. This data comes from the funnel.entities.provider_ids column.

property name*

string[]

nullable

Array [

string

]

archived stringnullable

The date when the entity was archived. Null when the entity is active.

references

object[]

required

Array [

id uuidnullable

The ID of the reference entity.

referenceType stringnullable

Possible values: [customer, oldCustomer, prospect, relation]

The type of the aggregation entity.

]

{
  "id": "adfdfaca-48f0-4f3b-b30a-c6d97293090c",
  "name": "Jean dupont",
  "created": "2024-01-01T00:00:00.000Z",
  "updated": "2024-01-01T00:00:00.000Z",
  "general": {
    "entryDateIntoRelationship": "string",
    "originCustomerRelationship": "incomingCall",
    "contactCustomerRelationship": "string",
    "remoteOpening": true,
    "dateLastMeeting": "string",
    "entryIntoRelationshipNote": "string",
    "gender": "male",
    "name": "string",
    "lastName": "string",
    "firstName": "string",
    "birthDate": "string",
    "birthZipCode": "string",
    "birthRegion": "string",
    "birthCity": "string",
    "birthCountry": "string",
    "birthName": "string",
    "deathDate": "string",
    "familySituation": "none",
    "marriageDate": "string",
    "nationality": "string",
    "matrimonialRegime": "string",
    "studiesLevel": "none",
    "occupation": "string",
    "occupationWording": "string",
    "retirementAge": 0,
    "annualIncome": "string",
    "heritageOrigin": "string",
    "sectorOfActivity": "string",
    "dateEntryRelationship": "string",
    "idCard": "string",
    "idNumber": "string",
    "issueDate": "string",
    "authority": "string",
    "expirationDate": "string",
    "idNIF": "string",
    "idMIF": "string",
    "taxResidence": "string",
    "customerClassificationMIF": "string",
    "classificationDate": "string",
    "pep": true,
    "usPerson": true,
    "legalCapacity": "noMeasure",
    "tag": "string",
    "referencesType": "customer",
    "updated": "string",
    "homeAdress": "string",
    "complement": "string",
    "postalCode": "string",
    "note": "string",
    "city": "string",
    "secondaryNationality": "string",
    "country": "string",
    "professionalCategory": "string",
    "externalClientFileReference": "string",
    "information": {
      "socialReason": "string",
      "contact": "string",
      "firstAddress": "string",
      "secondAddress": "string",
      "postalCode": "string",
      "city": "string",
      "country": "string",
      "phone": "string",
      "fax": "string",
      "email": "user@example.com",
      "website": "string",
      "holdingId": "string",
      "siren": "string",
      "siret": "string",
      "ape": "string",
      "rcsNumber": "string",
      "creationDate": "string",
      "legalForm": "string",
      "socialCapital": 0,
      "headOfficeAddress": "string",
      "managers": [
        {
          "managerID": "string",
          "primary": true
        }
      ],
      "seniorAdvisor": "string",
      "secondaryAdvisor": "string",
      "entryDateIntoRelationship": "string",
      "originCustomerRelationship": "incomingCall",
      "contactCustomerRelationship": "string",
      "remoteOpening": true,
      "dateLastMeeting": "string",
      "entryIntoRelationshipNote": "string",
      "ownership": 0,
      "valuation": 0
    },
    "managers": {
      "lastNameFirstName": "string",
      "function": "string",
      "birthDate": "string",
      "nationality": "string",
      "personalAddress": "string",
      "personalPhoneNumber": "string",
      "personalEmailAddress": "user@example.com",
      "shareholderInformation": "string",
      "idCard": "string",
      "idNumber": "string"
    },
    "nbManagers": {
      "lastNameFirstName": "string",
      "function": "string",
      "birthDate": "string",
      "nationality": "string",
      "personalAddress": "string",
      "personalPhoneNumber": "string",
      "personalEmailAddress": "user@example.com",
      "shareholderInformation": "string",
      "idCard": "string",
      "idNumber": "string"
    },
    "bankAccounts": {
      "banks": "string",
      "iban": "string",
      "bankAccountNumbers": "string",
      "bic": "string"
    },
    "activities": {
      "mainActivities": "string",
      "secondaryActivities": "string",
      "clients": "string",
      "suppliers": "string",
      "competitors": "string"
    }
  },
  "details": {
    "street": "string",
    "zipCode": "string",
    "city": "string",
    "addressSupplement": "string",
    "workStreet": "string",
    "workZipCode": "string",
    "workCity": "string",
    "workAddressSupplement": "string",
    "otherStreet": "string",
    "otherZipCode": "string",
    "otherCity": "string",
    "otherAddressSupplement": "string",
    "firstPhoneNumber": "string",
    "secondPhoneNumber": "string",
    "personalEmail": "user@example.com",
    "otherEmail": "user@example.com",
    "fiscalAddress": "string",
    "country": "string",
    "otherCountry": "string",
    "workCountry": "string"
  },
  "type": "person",
  "assets": [
    {
      "ownership": 0,
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "providers": {
    "provider1": [
      "id1",
      "id2"
    ],
    "provider2": [
      "id3"
    ]
  },
  "archived": "2024-01-01T00:00:00.000Z",
  "references": [
    {
      "id": "e1f2d3c4-b5a6-7b8c-9d0e-f1a2b3c4d5e6",
      "referenceType": "customer"
    }
  ]
}

Get entity informations

/companies/:companyID/entities/:entityID

Request​

Path Parameters

Query Parameters

Responses​

Request

Responses