GET api/Contact/{handle}?user={user}

Return the contact specified by handle

Request Information

URI Parameters

NameDescriptionTypeAdditional information
handle

Contact handle

string

Required

user

Optional user handle - if empty logged in user will be used

string

None.

Body Parameters

None.

Response Information

Resource Description

A contact object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
400 - bad request
401 - unauthorized
404 - not found
500 - internal server error

Contact
NameDescriptionTypeAdditional information
Name

Contact name (firstname surname for individual else orgname)

string

None.

Birthday

Date of birth

date

None.

PlaceOfBirth

Place of birth

string

None.

CleTitulaire

Registry contact password

string

None.

Siren

string

None.

Intracom

string

None.

Mark

string

None.

Passport

string

None.

Identitycard

string

None.

Duns

string

None.

AssoWaldec

Association WALDEC number

string

None.

AssoCreDate

Association create date

date

None.

AssoDecDate

Association declaration date

date

None.

AssoPubPage

integer

None.

AssoPubAnnounce

integer

None.

LocalNumber

string

None.

ExternalId

string

None.

IsActive

boolean

None.

Account

decimal number

None.

AuthorizedBank

decimal number

None.

VerifyAutoRenew

When false the autorenews pass without account verification. Default is true

boolean

None.

HasTva

Is the contact subject to tva

boolean

None.

RateTva

The tva rate for this contact

decimal number

None.

Extension

List of extension

Collection of Object_Extension

None.

Handle

Contact handle

string

None.

Entity

Entity type, 1 organization, 2 individual

integer

None.

OrgName

Organization name

string

Matching regular expression pattern: [A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&@[\]\/^_`|}{]{1,150}

String length: inclusive between 1 and 150

LastName

Last name

string

Matching regular expression pattern: [A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&@[\]\/^_`|}{]{1,150}

String length: inclusive between 1 and 150

FirstName

First name

string

Matching regular expression pattern: [A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&@[\]\/^_`|}{]{1,150}

String length: inclusive between 1 and 150

Address

Address line 1

string

Matching regular expression pattern: ^(?![A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*\b([bB][pP]|[cC][eE][dD][eE][xX])\b)[A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*$

String length: inclusive between 1 and 250

Address2

Address line 2

string

Matching regular expression pattern: ^(?![A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*\b([bB][pP]|[cC][eE][dD][eE][xX])\b)[A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*$

String length: inclusive between 1 and 250

City

string

Matching regular expression pattern: ^(?![A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*\b([bB][pP]|[cC][eE][dD][eE][xX])\b)[A-Za-z0-9áàâäãåçéèêëíìîïñóòôöõúùûüýÿæœÁÀÂÄÃÅÇÉÈÊËÍÌÎÏÑÓÒÔÖÕÚÙÛÜÝŸÆŒß \.!#$%'()*+,:;=\-?&[\]\/^_`|}{]*$

String length: inclusive between 1 and 150

Pc

Post code

string

Matching regular expression pattern: [ a-zA-Z0-9._/-]{1,30}

String length: inclusive between 1 and 30

Cc

ISO 2 char country code

string

Matching regular expression pattern: [A-Za-z]{2}

String length: inclusive between 2 and 2

Sp

string

Matching regular expression pattern: [A-Za-z0-9 \.\-!#$%'()*+,:;=?@[\]\/^_`|}{]{0,80}

String length: inclusive between 1 and 80

Phone

Phone number

string

Matching regular expression pattern: \+[0-9]{1,3}\.[0-9]{1,15}

Fax

Fax number

string

Matching regular expression pattern: \+[0-9]{1,3}\.[0-9]{1,15}

MailAddress

Email address

string

Matching regular expression pattern: [0-9a-zA-Z_\.-]+@(([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-zA-Z][A-Z0-9a-z-]*[0-9a-zA-Z]\.)+[a-zA-Z]{2,20})

String length: inclusive between 1 and 200

groupePrixID

Price group id

decimal number

None.

Response Formats

application/json, text/json

Sample:
{
  "Name": "sample string 1",
  "Birthday": "2025-04-04T00:08:49.9331516+02:00",
  "PlaceOfBirth": "sample string 2",
  "CleTitulaire": "sample string 3",
  "Siren": "sample string 4",
  "Intracom": "sample string 5",
  "Mark": "sample string 6",
  "Passport": "sample string 7",
  "Identitycard": "sample string 8",
  "Duns": "sample string 9",
  "AssoWaldec": "sample string 10",
  "AssoCreDate": "2025-04-04T00:08:49.9331516+02:00",
  "AssoDecDate": "2025-04-04T00:08:49.9331516+02:00",
  "AssoPubPage": 1,
  "AssoPubAnnounce": 1,
  "LocalNumber": "sample string 11",
  "ExternalId": "sample string 12",
  "IsActive": true,
  "Account": 14.0,
  "AuthorizedBank": 15.0,
  "VerifyAutoRenew": true,
  "HasTva": true,
  "RateTva": 18.1,
  "Extension": [
    {
      "Id": 1,
      "Key": "sample string 2",
      "Value": "sample string 3"
    },
    {
      "Id": 1,
      "Key": "sample string 2",
      "Value": "sample string 3"
    }
  ],
  "Handle": "sample string 19",
  "Entity": 20,
  "OrgName": "sample string 21",
  "LastName": "sample string 22",
  "FirstName": "sample string 23",
  "Address": "sample string 24",
  "Address2": "sample string 25",
  "City": "sample string 26",
  "Pc": "sample string 27",
  "Cc": "sample string 28",
  "Sp": "sample string 29",
  "Phone": "sample string 30",
  "Fax": "sample string 31",
  "MailAddress": "sample string 32",
  "groupePrixID": 1.0
}

application/xml, text/xml

Sample:
<Contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Contact">
  <Address>sample string 24</Address>
  <Address2>sample string 25</Address2>
  <Cc>sample string 28</Cc>
  <City>sample string 26</City>
  <Entity>20</Entity>
  <Fax>sample string 31</Fax>
  <FirstName>sample string 23</FirstName>
  <Handle>sample string 19</Handle>
  <LastName>sample string 22</LastName>
  <MailAddress>sample string 32</MailAddress>
  <OrgName>sample string 21</OrgName>
  <Pc>sample string 27</Pc>
  <Phone>sample string 30</Phone>
  <Sp>sample string 29</Sp>
  <groupePrixID>1</groupePrixID>
  <Account>14</Account>
  <AssoCreDate>2025-04-04T00:08:49.9331516+02:00</AssoCreDate>
  <AssoDecDate>2025-04-04T00:08:49.9331516+02:00</AssoDecDate>
  <AssoPubAnnounce>1</AssoPubAnnounce>
  <AssoPubPage>1</AssoPubPage>
  <AssoWaldec>sample string 10</AssoWaldec>
  <AuthorizedBank>15</AuthorizedBank>
  <Birthday>2025-04-04T00:08:49.9331516+02:00</Birthday>
  <CleTitulaire>sample string 3</CleTitulaire>
  <Duns>sample string 9</Duns>
  <Extension>
    <Object_Extension>
      <Id>1</Id>
      <Key>sample string 2</Key>
      <Value>sample string 3</Value>
    </Object_Extension>
    <Object_Extension>
      <Id>1</Id>
      <Key>sample string 2</Key>
      <Value>sample string 3</Value>
    </Object_Extension>
  </Extension>
  <ExternalId>sample string 12</ExternalId>
  <HasTva>true</HasTva>
  <Identitycard>sample string 8</Identitycard>
  <Intracom>sample string 5</Intracom>
  <IsActive>true</IsActive>
  <LocalNumber>sample string 11</LocalNumber>
  <Mark>sample string 6</Mark>
  <Name>sample string 1</Name>
  <Passport>sample string 7</Passport>
  <PlaceOfBirth>sample string 2</PlaceOfBirth>
  <RateTva>18.1</RateTva>
  <Siren>sample string 4</Siren>
  <VerifyAutoRenew>true</VerifyAutoRenew>
</Contact>