# List follow-ups

Returns paginated follow-ups (rapprochements) for a customer.

A follow-up links a customer to a product they are interested in,
tracking the progression of the relationship.

Endpoint: GET /customers/{customerId}/follow-ups
Version: 1.6.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer opaque

## Path parameters:

  - `customerId` (integer, required)
    ID of the customer.

## Query parameters:

  - `per_page` (integer)
    Number of results per page. Maximum 200, default 25.

## Response 200:

  - `200` (unknown)
    Paginated list of follow-ups

## Response 200 fields (application/json):

  - `data` (array)

  - `data.customerId` (integer)
    Customer ID.
    Example: 789

  - `data.productId` (integer)
    Product ID.
    Example: 12345

  - `data.opinion` (object)
    Agent's opinion on the match.

  - `data.opinion.value` (integer | null)

  - `data.opinion.text` (string | null)

  - `data.rating` (integer | null)
    Customer interest rating (0-5).
    Example: 4

  - `data.visibleCustomer` (boolean | null)
    Whether the follow-up is visible to the customer (portal).

  - `data.updatedAt` (string | null)
    Last update timestamp.

  - `data.progress` (string | null)
    Follow-up progress label.

  - `meta` (object)
    Pagination metadata for cursor-based listings.

  - `meta.per_page` (integer)
    Number of items returned per page.
    Example: 50

  - `meta.next_cursor` (string | null)
    Cursor to pass in the next request to fetch the next page.
Null when there is no next page.
    Example: eyJpZCI6MTIzfQ==

  - `meta.prev_cursor` (string | null)
    Cursor for the previous page. Null on first page.

  - `links` (object)
    Ready-to-use links for cursor-based navigation.

  - `links.next` (string | null)
    URL of the next page, or null.

  - `links.prev` (string | null)
    URL of the previous page, or null.

## Response 403:

  - `403` (unknown)
    Access denied. The error `code` is always `FORBIDDEN`; the `message` gives the cause:
- `You do not have permission to perform this action.`
 — the access does not

hold the API pack / right required by the endpoint.
- `Insufficient scope for this request.`
 — the resource targeted by the request

(user, customer, product, agency, transaction, ...) is outside the scope of

the authenticated access.
- `Access denied for this editor.`
 /
`Your IP address has been blocked.`
 —

editor or IP restriction.

## Response 403 fields (application/json):

  - `error` (object)

  - `error.code` (string, required)

  - `error.message` (string, required)

## Response 403 examples:

  - `Missing API pack / right` (unknown)

  - `Resource outside the scope of the access` (unknown)

