Endpoint Categories

ProffConnect communicates only with a predefined, read-only set of Proff API endpoints. These endpoints supply public business information, classification data, location structures, and token usage details required for the ProffConnect experience inside Salesforce.

• All endpoints are HTTPS, GET-only, and read-only
• Endpoints cannot be modified by customers
• A valid Proff API token (BYOT) is required for all calls

This page provides an overview of every endpoint category used by ProffConnect.

---

1. Business Person Endpoints

Used to retrieve publicly available information about registered business roles, such as board members, signatories, and key executives.

Personal details that may be sensitive (e.g., names, birthdates) are marked as sensitive data in the Field Mapping.

Endpoints Used

Operation	Description	Path
Business Person by Id	Retrieves details about a specific business person	/api/persons/business/{country}/{id}

---

2. Eniro Pro Company Endpoints

These endpoints return enhanced business listings and location data used for search, filtering, and navigation inside Salesforce.

Endpoints Used

Operation	Description	Path
Company List Search	Search for EniroPro companies	/api/companies/eniropro/{country}
Company Location Tree	Retrieve hierarchical location data for Pro companies	/api/companies/eniropro/locations/{country}

---

3. Eniro Pro Industry Endpoints

Provides structured industry classifications used in search filters and business categorization.

Endpoints Used

Operation	Description	Path
Industry List	List Eniro Pro industry categories	/api/industries/eniropro/{country}

---

4. Register Company Endpoints

These endpoints deliver official company register information such as organisation numbers, company types, and business categories.

All details returned are publicly available business information.

Endpoints Used

Operation	Description	Path
Company Business Categories	List official business categories	/api/companies/register/businesscategories/{country}
Company by Org Number	Retrieve register data for a specific organisation number	/api/companies/register/{country}/{id}
Company Types	List official company types	/api/companies/register/companytypes/{country}
Company List Search	Search register companies by country	/api/companies/register/{country}

---

5. Service Metadata Endpoints

Used exclusively to retrieve information about the customer's API token, including quota usage and validity.

No organisation numbers, Salesforce record IDs, or personal data are sent in these requests.

Endpoints Used

Operation	Description	Path
Token Information	Retrieves token quota, usage, and expiry details	/api/service/tokeninformation

---

6. Endpoint Security Restrictions

To maintain a secure and predictable integration, ProffConnect enforces the following rules:

• GET-only: No write, update, or delete operations
• HTTPS enforced: All requests use TLS 1.2+
• Fixed endpoint list: Customers cannot change or add endpoints
• Strict parameter control: Only country codes, organisation numbers, and search terms are passed
• No Salesforce data sent: No CRM data leaves Salesforce

These restrictions ensure that usage is transparent, safe, and compliant across all Salesforce environments.