Fetch contacts

Production

https://api.belga.press/belgapress/api

GET

/users/{userId}/contacts

Returns a paginated list of the current user's contacts.
The list can be filtered and sorted using query parameters.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/auth

Token URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/token

Scopes:

openid

offline_access

profile

email

Path Params

Query Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.belga.press/belgapress/api/users//contacts?count&offset&search&order&contacttypes&contactgroupids&contactids&withfeatures&contacttagids' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "_links": {
        "next": "http://example.com",
        "prev": "http://example.com",
        "self": "http://example.com"
    },
    "_meta": {
        "total": 0
    },
    "data": [
        {
            "id": 0,
            "userId": 0,
            "createdUserId": 0,
            "contactType": "INTERNAL",
            "invited": true,
            "collaboration": "PRIVATE",
            "firstName": "string",
            "lastName": "string",
            "email": "user@example.com",
            "phone": "string",
            "linkedin": "string",
            "twitter": "string",
            "organizationName": "string",
            "role": "string",
            "notes": "string",
            "contactGroups": [
                {
                    "id": 0,
                    "name": "string"
                }
            ],
            "tags": [
                {
                    "id": 0,
                    "name": "string"
                }
            ]
        }
    ]
}

Modified at 2025-11-05 16:04:27

Fetch minimal contacts

Create contacts