Project - List

Purpose

Retrieve a list of Projects which your API Credentials have access to. This JSON response includes Project data and a count of the number of Credits attached to it (in case you need to run a subsequent request to get Credits Resources.

Request

Endpoint

GET /projects

Authentication

Include your API Key within the x-api-key header as described here.

Parameters

The following table lists the parameters that this query supports. All of the parameters listed are query parameters.

Parameter	Type	Definition
page	int	The page number of the results you want (set to 1, if not provided)
internal_ids	string	comma seperated list of your internal string ids (optional)
ids	string	comma seperated list of Incentify integer ids (optional)

Request Body

Do not provide a request body when calling this method.

Response

If successful, this method returns a response body with the following structure:

Response Body

{
    "code":200,
    "success":true,
    "data": [
        Project Resources listed here... (See "Project - Overview" page)
    ],
    "errors": [],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "[path_to_endpoint]",
        "per_page": 50,
        "to": 10,
        "total": 10
    },
    "links": {
        "first": "[path_to_endpoint]?page=1",
        "last": "[path_to_endpoint]?page=1",
        "prev": null,
        "next": null
    }
}

Properties

The following table defines the properties that appear in this resource:

Key	Type	Definition
code	integer	HTTP Status Code (ie; 200, 403, etc).
success	boolean	Either true (success) or false (fail).
data	list	List of Projects returned. The data structure of each Project is a Project Resource.
errors	object	If the request fails, this will contain information about the error.
meta	object	Contains information about pagination and total record count.
links	object	Contains pre-built links for forward/backward pagination.