v1

latestOpenAPI 3.0.12026-07-2464217456.8 KB
Projects

Get all projects

get/1.0/projects

Query parameters

pageSizenumber
Example:100

This parameter sets the maximum number of responses to be displayed per page. If the page size is insufficient to accommodate the whole number of responses obtained, the pagination object will include a link to the next page as well as the next page token. If left blank, it defaults to 100.

pageTokenstring
Example:59c12a42-dd10-11ed-afa1-0242ac120002

Use this parameter to specify the pageToken of a page to which you want to navigate. This pageToken can be obtained from a previous request which specified a limit and will only be active for 15 minutes after it is created.

includeFieldsstring[]

This query parameter allows you to specify which fields should be returned in the response body by selecting from the drop down. To get the relevant fields, use comma separated values. If the field is left blank, the default properties are returned.

includeAllFieldsboolean
Example:true

This query parameter allows you to specify if all the fields should be returned in the response body. If the field is left blank, the default properties are returned.

sortBy'projectName' | 'startDate' | 'dueDate' | 'startDateActual' | 'dueDateActual' | 'annualizedRecurringRevenue' | 'projectFee'

For sorting the responses by the provided field, use the sortBy parameter.

sortOrder'ASC' | 'DESC'

The sortOrder param can be used to specify the sorting order, which can be Ascending (ASC) or Descending (DESC). Descending is the default option.

match'all' | 'any'

You can use the match param to specify if we need to filter the entries using either AND(all) / OR(any). Defaults to AND.

startDate.gtstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than the given start date.

startDate.eqstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain exact matches of projects that match the given start date.

startDate.ltstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than the given start date.

startDate.gestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than or equal to the given start date.

startDate.lestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than or equal to the given start date.

dueDate.gtstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than the given due date.

dueDate.eqstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain exact matches of projects that match the given due date.

dueDate.ltstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than the given due date.

dueDate.gestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than or equal to the given due date.

dueDate.lestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than or equal to the given due date.

startDateActual.gtstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than the given actual start date.

startDateActual.eqstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain exact matches of projects that match the given actual start date.

startDateActual.ltstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than the given actual start date.

startDateActual.gestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than or equal to the given actual start date.

startDateActual.lestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than or equal to the given actual start date.

dueDateActual.gtstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than the given actual due date.

dueDateActual.eqstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain exact matches of projects that match the given actual due date.

dueDateActual.ltstring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than the given actual due date.

dueDateActual.gestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are greater than or equal to the given actual due date.

dueDateActual.lestring
Example:2023-03-28

You can use this param to provide a date and the responses will contain projects whose date are less than or equal to the given actual due date.

createdAt.gtinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are greater than the given project created date.

createdAt.eqinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain exact matches of projects that match the given project created date.

createdAt.ltinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are less than the given project created date.

createdAt.geinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are greater than or equal to the given project created date.

createdAt.leinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are less than or equal to the given project created date.

updatedAt.gtinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are greater than the given project updated date.

updatedAt.eqinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain exact matches of projects that match the given project updated date.

updatedAt.ltinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are less than the given project updated date.

updatedAt.geinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are greater than or equal to the given project updated date.

updatedAt.leinteger
Example:1625164800000

You can use this param to provide an epoch milli value and the responses will contain projects whose date are less than or equal to the given project updated date.

annualizedRecurringRevenue.eqnumber
Example:10000

You can use this param to specify some value as ARR and the responses will contain exact matches of projects that match the given value.

annualizedRecurringRevenue.gtnumber
Example:10000

You can use this param to specify some value as ARR and the responses will contain exact matches of projects greater than that of the given value.

annualizedRecurringRevenue.ltnumber
Example:10000

You can use this param to specify some value as ARR and the responses will contain exact matches of projects lesser than that of the given value.

projectFee.eqnumber
Example:10000

You can use this param to specify some value as project fee and the responses will contain exact matches of projects that match the given value.

projectFee.gtnumber
Example:10000

You can use this param to specify some value as project fee and the responses will contain matches of projects greater than that of the given value.

projectFee.ltnumber
Example:10000

You can use this param to specify some value as project fee and the responses will contain matches of projects lesser than that of the given value.

customerId.eqstring

You can use this param to provide a customer company id and the responses will contain exact matches of projects that match the given customer company id.

customerId.oneOfstring
Example:1,2,3

You can use this param to provide customer company ids separated by commas and the responses will contain matches of projects that match any of the given customer company id.

customerId.noneOfstring
Example:1,2,3

You can use this param to provide customer company id separated by commas and the responses will not contain matches of projects that match the given set of customer company id.

teamMemberId.eqstring

You can use this param to provide a team member id and the responses will contain exact matches of projects that match the given team member id.

teamMemberId.oneOfstring
Example:1,2,3

You can use this param to provide team member ids separated by commas and the responses will contain matches of projects that match any of the given team member id.

teamMemberId.noneOfstring
Example:1,2,3

You can use this param to provide team member id separated by commas and the responses will not contain matches of projects that match the given set of team member id.

companyId.eqstring

You can use this param to provide a customer company id and the responses will contain exact matches of projects that match the given customer company id.

companyId.oneOfstring
Example:1,2,3

You can use this param to provide customer company ids separated by commas and the responses will contain matches of projects that match any of the given customer company id.

companyId.noneOfstring
Example:1,2,3

You can use this param to provide customer company id separated by commas and the responses will not contain matches of projects that match the given set of customer company id.

projectName.eqstring
Example:Stark Onboarding

You can use this param to specify some project name and the responses will contain exact matches of projects that match the given name.

projectName.cnstring
Example:Stark Onboarding

You can use this param to specify some project name and the responses will contain matches of projects that match the given name.

projectName.ncstring
Example:Stark Onboarding

You can use this param to specify some project name and the responses will not contain matches of projects that match the given name.

inferredProgress.eqstring[]

You can use this param to provide a inferred progress and the responses will contain exact matches of projects that match the given inferred progress.

contractType.eqstring[]

You can use this param to provide a contract type and the responses will contain exact matches of projects that match the given contract type

contractType.oneOfstring[]

You can use this param to provide contract types separated by commas and the responses will contain matches of projects that match any of the given contract types.

contractType.noneOfstring[]

You can use this param to provide contract types separated by commas and the responses will not contain matches of projects that match the given set of contract types.

budgetedHours.gtstring

You can use this param to provide a budgeted hour and the responses will contain projects whose budgeted hours are greater than the given budgeted hour.

budgetedHours.eqstring

You can use this param to provide a budgeted hour and the responses will contain exact matches of projects that match the given budgeted hour.

budgetedHours.ltstring

You can use this param to provide a budgeted hour and the responses will contain projects whose budgeted hours are less than the given budgeted hour.

budgetedHours.gestring

You can use this param to provide a budgeted hour and the responses will contain projects whose budgeted hours are greater than or equal to the given budgeted hour.

allocatedHours.lestring

You can use this param to provide a allocated hour and the responses will contain projects whose allocated hours are less than or equal to the given allocated hour.

allocatedHours.gtstring

You can use this param to provide a allocated hour and the responses will contain projects whose allocated hours are greater than the given allocated hour.

allocatedHours.eqstring

You can use this param to provide a allocated hour and the responses will contain exact matches of projects that match the given allocated hour.

allocatedHours.ltstring

You can use this param to provide a allocated hour and the responses will contain projects whose allocated hours are less than the given allocated hour.

allocatedHours.gestring

You can use this param to provide a allocated hour and the responses will contain projects whose allocated hours are greater than or equal to the given allocated hour.

customersInvited.gtstring

You can use this param to provide a number and the responses will contain projects that have more customers invited than given number of customers invited.

customersInvited.eqstring

You can use this param to provide a number and the responses will contain exact matches of projects that exactly have the given number of customers invited.

customersInvited.ltstring

You can use this param to provide a number and the responses will contain projects that have less customers invited than given number of customers invited.

customersInvited.gestring

You can use this param to provide a number and the responses will contain projects that have equal or more customers invited than given number of customers invited.

customersInvited.lestring

You can use this param to provide a number and the responses will contain projects that have equal or less customers invited than given number of customers invited.

customersJoined.gtstring

You can use this param to provide a number and the responses will contain projects that have more customers joined than given number of customers joined.

customersJoined.eqstring

You can use this param to provide a number and the responses will contain exact matches of projects that exactly have the given number of customers joined.

customersJoined.ltstring

You can use this param to provide a number and the responses will contain projects that have less customers joined than given number of customers joined.

customersJoined.gestring

You can use this param to provide a number and the responses will contain projects that have equal or more customers joined than given number of customers joined.

customersJoined.lestring

You can use this param to provide a number and the responses will contain projects that have equal or less customers joined than given number of customers joined.

includeArchive.eqboolean

You can use this parameter to specify whether responses will include the archived projects.

status.eqstring

You can use this param to provide status and the responses will contain projects that are equal to the given status

status.oneOfstring
Example:1,2

You can use this param to provide statuses and the responses will contain projects that match one of the given statuses

status.noneOfstring
Example:1,2

You can use this param to provide statuses and the responses will contain projects that matches none of the given statuses

externalReferenceId.eqstring
Example:project_181866171876

You can use this param to provide external reference id and the responses will contain projects that are equal to the given id

Response

The requested action was successfully executed.

Example response

{
  "data": [
    {
      "projectId": 201,
      "projectName": "Acme onboarding",
      "startDate": "2023-03-28",
      "dueDate": "2023-03-28",
      "createdAt": 1681319726000,
      "updatedAt": 1681319726000,
      "owner": {
        "emailId": "john.doe@rocketlane.com",
        "userId": 201,
        "firstName": "John",
        "lastName": "Doe"
      },
      "teamMembers": {
        "members": [
          {
            "emailId": "john.doe@rocketlane.com",
            "userId": 201,
            "firstName": "John",
            "lastName": "Doe"
          }
        ],
        "customers": [
          {
            "emailId": "rachel.green@acme.com",
            "userId": 301,
            "firstName": "Rachel",
            "lastName": "Green"
          }
        ],
        "customerChampion": {
          "emailId": "ruth.bell@acme.com",
          "userId": 302,
          "firstName": "Ruth",
          "lastName": "Bell"
        }
      },
      "status": {
        "value": 2,
        "label": "In progress"
      },
      "fields": [
        {
          "fieldId": 201,
          "fieldLabel": "MRR",
          "fieldValue": "1000",
          "fieldValueLabel": "1000"
        }
      ],
      "customer": {
        "companyId": 201,
        "companyName": "Acme Inc",
        "companyUrl": "https://www.acme.com"
      },
      "partnerCompanies": [
        {
          "companyId": 301,
          "companyName": "Modert Inc",
          "companyUrl": "https://www.modert.com"
        }
      ],
      "visibility": "EVERYONE",
      "createdBy": {
        "emailId": "john.doe@rocketlane.com",
        "userId": 201,
        "firstName": "John",
        "lastName": "Doe"
      },
      "updatedBy": {
        "emailId": "john.doe@rocketlane.com",
        "userId": 201,
        "firstName": "John",
        "lastName": "Doe"
      },
      "currency": "USD",
      "financials": {
        "fixedFeeContract": {
          "fixedFee": 100
        },
        "timeAndMaterialContract": {
          "rateCard": {
            "rateCardId": 21,
            "rateCardName": "US Project rate"
          },
          "projectBudget": 100
        },
        "subscriptionContract": {
          "subscriptionFrequency": "MONTHLY",
          "subscriptionStartDate": "2023-03-28",
          "periodMinutes": 60,
          "periodBudget": 10000,
          "noOfPeriods": 10
        },
        "metrics": {
          "actualRevenue": 10000,
          "estimatedRevenue": 200000,
          "actualCost": 200,
          "estimatedCost": 200,
          "actualProfit": 200,
          "estimatedProfit": 200,
          "actualProfitMargin": 200,
          "estimatedProfitMargin": 200,
          "estimateAtCompletion": 200,
          "estimationToCompletionInHours": 200
        }
      },
      "startDateActual": "2023-03-28",
      "dueDateActual": "2023-03-28",
      "annualizedRecurringRevenue": 10000,
      "projectFee": 100000,
      "budgetedHours": 10.5,
      "percentageBudgetedHoursConsumed": 42,
      "percentageBudgetConsumed": 42,
      "trackedHours": 530,
      "trackedMinutes": 530,
      "allocatedHours": 500,
      "allocatedMinutes": 500,
      "billableHours": 500,
      "billableMinutes": 500,
      "nonBillableHours": 500,
      "nonBillableMinutes": 500,
      "remainingHours": 530,
      "remainingMinutes": 530,
      "progressPercentage": 42,
      "currentPhases": [
        {
          "phaseId": 201,
          "phaseName": "Go live"
        }
      ],
      "sources": [
        {
          "prefix": "APAC",
          "startDate": "2023-03-28",
          "templateId": 201,
          "templateName": "Simple Onboarding"
        }
      ],
      "plannedDurationInDays": 24,
      "inferredProgress": "RUNNING_LATE",
      "projectAgeInDays": 38,
      "customersInvited": 5,
      "customersJoined": 12,
      "externalReferenceId": "pr_8171"
    }
  ],
  "pagination": {
    "pageSize": 100,
    "hasMore": true,
    "totalRecordCount": 10398,
    "nextPage": "https://api.rocketlane.com/api/1.0/projects?includeFields=category,minutes&billable.eq=false&sortBy=startDate&sortOrder=desc&pageToken=e4a3dd8e-e338-11ed-b5ea-0242ac120002&limit=100&assignee.any=1&startDate.gt=2022-01-02",
    "nextPageToken": "e4a3dd8e-e338-11ed-b5ea-0242ac120002"
  }
}