# PartnerIngressService

All endpoints on this service authenticate via Bearer token only (no identity headers).

```http
Authorization: Bearer <token>
```

## ListCompanies

Returns the associated companies for a given partner. Use this to look up the ID mappings between Basic Capital and the partner system.

```protobuf
service PartnerIngressService {
  rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse);
}

message ListCompaniesRequest {
  optional com.basiccapital.common.external.PaginationRequest pagination = 1;
}

message ListCompaniesResponse {
  repeated PartnerIdentityAssociation companies = 1;
  optional string next_page_token = 2;
}
```

**Data types:** [PartnerIdentityAssociation](/core-data-types/identity-and-agreements#partneridentityassociation)

**REST:** [`POST /v1/partner-rpc/com.basiccapital.systems.ingress.partner.PartnerIngressService/ListCompanies`](/openapi/partneringressservice/listcompanies)

## ListEmployees

Returns the associated employees for all companies associated with the partner. Use this to look up the ID mappings between Basic Capital and the partner system. You can optionally filter by `company_uuid`.

```protobuf
service PartnerIngressService {
  rpc ListEmployees(ListEmployeesRequest) returns (ListEmployeesResponse);
}

message ListEmployeesRequest {
  optional com.basiccapital.common.external.PaginationRequest pagination = 1;
  optional string company_uuid = 2;
}

message ListEmployeesResponse {
  repeated PartnerIdentityAssociation employees = 1;
  optional string next_page_token = 2;
}
```

**Data types:** [PartnerIdentityAssociation](/core-data-types/identity-and-agreements#partneridentityassociation)

**REST:** [`POST /v1/partner-rpc/com.basiccapital.systems.ingress.partner.PartnerIngressService/ListEmployees`](/openapi/partneringressservice/listemployees)