GET : Retrieve Company

This endpoint lets you retrieve one company for a given public Id.

This endpoint requires :

• brand_admin, media_admin or media_partner roles.

• r_companies scope.

Company info

GET https://api.piloty.fr/companies/:company-public-id

Important fields

• public_id : Unique identifier of the company

• is_published : Is the company is published throughout the media

Path Parameters

Name	Type	Description
company-public-id*	String	Public id of the job

200: OK success

[
    "data":{
            "id": "6295debf398f8985f09dc99d",
            "name": "Trusty",
            "public_id": "trusty",
            "size": "62cc627cf40fc5d45819d8f8",
            "sectors": [
                "630f96baa4ef90ff2a51ee34"
            ],
            "content": {
                "visual": {
                    "logo": "https://piloty-public-staging.s3.amazonaws.com/companiesDocuments/6295debf398f8985f09dc99d/6295debf398f8985f09dc99d_logo_1710944607812"
                },
                "description":"Lorem Ipsum ...",
                "language": "fr"
            },
            "is_published": true,
            "is_vme_page_published" : false
        }
]

401: Unauthorized unauthorized-limitation

{
    "status": 401,
    "error": "unauthorized-limitation",
    "errorMessage": "Unauthorized"
}

404: Not Found company-not-found

{
    "status": 404,
    "error": "company-not-found",
    "errorMessage": "Not found"
}

Request example

curl -X GET -G "https://api-piloty.fr/jobs/opened/:job-public-id" \
    -H "Authorization: Bearer PILOTY_TOKEN" \