View Partner

GET /partners/{id}
Copied
Arrow
                https://api.ocamba.com/v1/hood/partners/{id}

Retrieves the details of a Partner if a valid identifier was provided.

path Parameters
Arrow
Name
Description
idstringrequired
Unique resource identifier.


Example: 12345
query Parameters
Arrow
Name
Description
fieldsstring
Fields parameter represents array of dimensions and measures. Dimensions are used to categorize, segment, and reveal the details of the data. Measures contain numeric, quantitative values that can be measured. At least one measure is required.


Example: fields=field1,field2,field3
viewstring
Hood API returns full representation of the resource using the "view=full" query parameter. If not specified, the default view will be used.

Note that the "fields" parameter has precedence over the "view" parameter.


Example: view=full/default

Response status codes
Arrow
200 - OK
Arrow
Name
Description
items[ partner ]
An array conteining the partner specified by Id.
Partner
Name
Description
archivednumber
Describes if the partner is archived or not. Can only be adjusted through the dedicated endpoint.

Possible values: 0 | 1
billing_addressbilling-address
The billing address of the partner.
Billing Address
Name
Description
citystring
City.


Example: Toronto
countrystring
Accepts only valid 2 letter country codes.


Example: ca
postal_codestring
Postal code.


Example: M4C 1A1
streetstring
Street.


Example: 108 Hanson St
company_idstring
A unique identifier generated by the Ocamba.


Example: 2136950
contactcontact
The contact of the partner.
Contact
Name
Description
emailstring
The email of the partner.


Example: [email protected]
mobilestring
The mobile phone of the partner.


Example: +15551234567
phonestring
The landline of the partner.


Example: +441632960961
sipstring
The SIP of the partner.


Example: [email protected]
skypestring
The skype contact of the partner.


Example: john.doe123
websitestring
The website of the partner.


Example: https://www.example.com
create_timestring
Timezone: GMT.


Example: 2021-10-29 12:47:00
descriptionstring
The description of the partner.


Example: Example description.
idstring
A unique identifier generated by the Ocamba.


Example: 1000018
manager_idsarray
Array of hood member id's created on the Ocamba platform.


Example: 11153151,6643410,3183560
managers[ managers ]
The array of managers of the partner defined by the menager_ids inserted.
Manager
Name
Description
emailstring
The email of the manager.


Example: [email protected]
idstring
The ID of the Manager, generated by Ocamba.


Example: 1000223
imagestring
The profile picture of the manager.


Example: https://sm.ocmcore.com/share/1231233/adex/media/profile-pic-36703721.jpg
namestring
The name of the manager.


Example: Alex Claire
statusstring
The status of the manager.


Example: active
namestring
The name of the partner


Example: Example Partner Name
payment_termspayment-terms
The payment terms to which the partner agreed.
Payment Terms
Name
Description
currency_codestring
Currency code.


Example: usd

Possible values: usd | eur
net_termsstring
Net Terms.


Example: net30

Possible values: net30 | net45 | net60 | net90
payment_frequencystring
The frequency of payment.


Example: annually

Possible values: monthly | quarterly | annually
payment_methodstring
Payment method.


Example: card

Possible values: bank-transfer | card | paypal
statusstring
Describes the status of the partner.


Example: active

Possible values: active | inactive | pending | suspended | terminated
systemnumber
Describes if the partner is system partner or not.


Example: 1

Possible values: 0 | 1
typearray
Describes the role of the partner.


Example: advertiser

Possible values: advertiser | publisher
update_timestring
Timezone: GMT.


Example: 2021-10-30 14:27:26
totalinteger
A total number of items.


Example: 1

tip
1 If you don't know the partner id, list the partners to find it.
note
1 If you want to read a specific archived partner, you should also use the 'archived' filter.

Response examples
Copied
Arrow
200 Arrow
  • 200
  • 200
{
  "total": 1,
  "items": [
    {
      id": "1000412",
      "company_id": "6197120",
      "manager_ids": [
        "1000220"
      ],
      "managers": [
        {
          "id": "1000220",
          "name": "Isabella Reed",
          "email": "[email protected]",
          "status": "active"
        }
      ],
      "name": "Hairdressing Claire",
      "description": "This is a publisher on a hairdressing website",
      "type": [
        "publisher"
      ],
      "status": "inactive",
      "payment_terms": {
        "payment_frequency": "quarterly",
        "payment_method": "card",
        "net_terms": "net90",
        "currency_code": "eur"
      },
      "billing_address": {
        "street": "Victoria Park Ave",
        "city": "Toronto",
        "post_code": "M4B 2J8",
        "country": "CA"
      },
      "contact": {
        "email": "[email protected]",
        "mobile": "+785596522",
        "phone": "+1235165336",
        "sip": "5259oskZYi9sw8",
        "skype": "dfa223ghjk",
        "website": "hairdresser-saloon.com"
      },
      "system": 0,
      "create_time": "2024-09-19 10:40:36",
      "update_time": "2024-09-19 10:40:36"
    }
  ]
}

{
  "total": 1,
  "items": [
    {
      "id": "1000018",
      "company_id": "2136950",
      "manager_ids": "11153151,6643410,3183560",
      "managers": [
        {
          "id": "1000223",
          "name": "Alex Claire",
          "status": "active",
          "email": "[email protected]",
          "image": "https://sm.ocmcore.com/share/1231233/adex/media/profile-pic-36703721.jpg"
        }
      ],
      "name": "Example Partner Name",
      "description": "Example description.",
      "type": "advertiser",
      "status": "active",
      "payment_terms": {
        "payment_frequency": "annually",
        "payment_method": "card",
        "net_terms": "net30",
        "currency_code": "usd"
      },
      "billing_address": {
        "street": "108 Hanson St",
        "city": "Toronto",
        "postal_code": "M4C 1A1",
        "country": "ca"
      },
      "contact": {
        "email": "[email protected]",
        "mobile": "+15551234567",
        "phone": "+441632960961",
        "sip": "[email protected]",
        "skype": "john.doe123",
        "website": "https://www.example.com"
      },
      "system": 1,
      "create_time": "2021-10-29 12:47:00",
      "update_time": "2021-10-30 14:27:26"
    }
  ]
}