Get cost detail for a member on a specific day.

GET

/costs/day

const url = 'https://api-us.suiteop.com/api/v1/costs/day?date=2026-04-15&memberId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-us.suiteop.com/api/v1/costs/day?date=2026-04-15&memberId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>'

Drill into ONE (member, day) — returns every time entry that day with its attributed cost row, PLUS orphan cost rows (materials / expenses without a clock-in), PLUS edit history. USE after listCostsByPeriod surfaces a day worth inspecting: ‘walk me through Maria’s Tuesday’, ‘why is Diego’s Thursday so high?’. For ‘all my costs in May’ use listCostsByPeriod with groupBy=day; this tool is strictly single-day-scoped. Pass memberId=null for the unassigned-cost bucket (orphan materials/expenses with no member).

Authorizations

apiKey

Parameters

Query Parameters

date

required

string format: date

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$/

memberId

required

Any of:

string
null

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

string

>= 1 characters

Responses

200

Success.

application/json

object

data

required

Response payload.

object

entries

required

Array<object>

object

attributedBillableCents

required

Any of:

number
null

number

attributedCostCents

required

Any of:

number
null

number

breakDefinitionId

required

Any of:

string
null

string

departmentColor

required

Any of:

string
null

string

departmentId

required

Any of:

string
null

string

departmentName

required

Any of:

string
null

string

durationMinutes

required

Any of:

number
null

number

endTime

required

Any of:

string
null

string format: date-time

isApproved

required

Any of:

boolean
null

boolean

kind

required

string

Allowed value: time_entry

notes

required

Any of:

string
null

string

propertyId

required

Any of:

string
null

string

propertyName

required

Any of:

string
null

string

startTime

required

string format: date-time

taskId

required

Any of:

string
null

string

taskTitle

required

Any of:

string
null

string

timeEntryId

required

string

type

required

string

orphanCosts

required

Array<object>

object

billableTotalCents

required

Any of:

number
null

number

costId

required

string

costType

required

string

departmentColor

required

Any of:

string
null

string

departmentId

required

Any of:

string
null

string

departmentName

required

Any of:

string
null

string

description

required

Any of:

string
null

string

flatCostCents

required

Any of:

number
null

number

isApproved

required

boolean

kind

required

string

Allowed value: cost_only

photos

required

Any of:

Array<string>
null

Array<string>

propertyId

required

Any of:

string
null

string

propertyName

required

Any of:

string
null

string

quantity

required

Any of:

string
null

string

taskId

required

Any of:

string
null

string

taskTitle

required

Any of:

string
null

string

totalCostCents

required

number

unitCostCents

required

Any of:

number
null

number

meta

required

Response metadata present on every success response.

object

pagination

Present on list responses.

object

limit

required

Page size used for this request.

integer

offset

required

Number of items skipped.

integer

total

required

Total number of matching items (across all pages).

integer

requestId

required

Unique identifier for this request.

string

Example

{
  "data": {
    "entries": [
      {
        "kind": "time_entry"
      }
    ],
    "orphanCosts": [
      {
        "kind": "cost_only"
      }
    ]
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute for this API key.

X-RateLimit-Remaining

integer

Remaining requests in the current rate-limit window.

X-RateLimit-Reset

integer

Unix epoch seconds when the rate-limit window resets.

X-Request-Id

string

Unique identifier for this request (matches meta.requestId in the body).

400

application/json

ValidationError

Error envelope returned for HTTP 400 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: validation_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "validation_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

401

application/json

AuthenticationError

Error envelope returned for HTTP 401 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: authentication_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "authentication_error"
  }
}

Headers

X-Request-Id

string

Request correlation id (also in meta.requestId).

403

application/json

AuthorizationError

Error envelope returned for HTTP 403 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: authorization_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "authorization_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

404

application/json

NotFoundError

Error envelope returned for HTTP 404 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: not_found_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "not_found_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

409

application/json

ConflictError

Error envelope returned for HTTP 409 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: conflict_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "conflict_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

422

application/json

BusinessRuleError

Error envelope returned for HTTP 422 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: business_rule_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "business_rule_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

429

application/json

RateLimitError

Error envelope returned for HTTP 429 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: rate_limit_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "rate_limit_error"
  }
}

Headers

Retry-After

integer

Number of seconds to wait before retrying.

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).

500

application/json

InternalError

Error envelope returned for HTTP 500 responses.

object

error

required

object

code

required

Machine-readable error code.

string

details

Optional structured details (omitted when undefined).

object

key

additional properties

any

message

required

Human-readable error message.

string

type

required

Error type.

string

Allowed values: internal_error

meta

required

object

requestId

required

string

Example

{
  "error": {
    "type": "internal_error"
  }
}

Headers

X-RateLimit-Limit

integer

Maximum requests per minute.

X-RateLimit-Remaining

integer

Remaining requests in the current window.

X-RateLimit-Reset

integer

Unix epoch seconds when the window resets.

X-Request-Id

string

Request correlation id (also in meta.requestId).