One month of this client's marketing-fee statement

curl --request GET \
  --url https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "month": "2026-08-01",
  "y_bps_monthly": 15,
  "days_in_month": 31,
  "days_stamped": 2,
  "daily": [
    {
      "date": "2026-08-01",
      "balance_minor": "1250000"
    },
    {
      "date": "2026-08-02",
      "balance_minor": "0"
    },
    {
      "date": "2026-08-03"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

RD Marketing Fee

One month of this client's marketing-fee statement

One row per calendar day: the date, the RD balance, and that day’s fee.

The rows are the stored daily principals, read rather than recomputed, so what the client reads and what Dakota priced cannot drift.

A balance is absent when the day has not been derived yet, and “0” when the client genuinely held no RD. Fees are absent for every day of a month whose rate has not been derived. Neither unknown is reported as a zero.

The client comes from the session. A month the client was not entitled to gets 404, as does a client who has never had a rate.

GET

rd-marketing-fee

statements

{month}

One month of this client's marketing-fee statement

curl --request GET \
  --url https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/rd-marketing-fee/statements/{month}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "month": "2026-08-01",
  "y_bps_monthly": 15,
  "days_in_month": 31,
  "days_stamped": 2,
  "daily": [
    {
      "date": "2026-08-01",
      "balance_minor": "1250000"
    },
    {
      "date": "2026-08-02",
      "balance_minor": "0"
    },
    {
      "date": "2026-08-03"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Customer Not Found",
  "status": 404,
  "detail": "Customer cst_2abc123 was not found in your organization.",
  "instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
  "request_id": "req_7f3a8b2c"
}

Authorizations

x-api-key

string

header

required

Path Parameters

month

string<date>

required

First day of the month (UTC).

Response

The month's statement

month

string<date>

required

y_bps_monthly

number<double>

required

The rate in force for THIS month, in monthly basis points. A later rate change does not rewrite it.

days_in_month

integer

required

Calendar days in the month — the divisor, never the number of rows stored.

days_stamped

integer

required

Days whose principal is stored. Lower than days_in_month while the month is still being derived or still running, which is how a partial month is shown as partial rather than as a complete small one.

daily

object[]

required

Show child attributes

owed_minor

string

What the month owes this client, RD minor units. ABSENT until the month is priced — never zero, which would state that nothing is owed.

avg_daily_balance_minor

string

The mean of the month's stored daily principals. Absent while the month is incomplete.

⌘I

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Legal

Insights

RD Marketing Fee

Payouts

One month of this client's marketing-fee statement

Authorizations

Path Parameters

Response