List administrative tasks - Dintero Documentation

aid_mgmnt_tasks_get

curl --request GET \
  --url https://api.dintero.com/v1/accounts/{oid}/management/tasks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dintero.com/v1/accounts/{oid}/management/tasks', 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.dintero.com/v1/accounts/{oid}/management/tasks"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

{
  "tasks": [
    {
      "id": "T55500000.task.JR97L9E",
      "type": "payout_destination_backfill",
      "account_id": "P55500000",
      "status": "pending",
      "attempts": 1,
      "group_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "result": {},
      "error": {
        "code": "entity_mismatch",
        "message": "2 of 5 projections failed"
      },
      "updated_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z"
    }
  ],
  "starting_after": "T55500000.task.JR97L9E"
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

GET

https://api.dintero.com/v1

accounts

{oid}

management

tasks

aid_mgmnt_tasks_get

curl --request GET \
  --url https://api.dintero.com/v1/accounts/{oid}/management/tasks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dintero.com/v1/accounts/{oid}/management/tasks', 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.dintero.com/v1/accounts/{oid}/management/tasks"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

{
  "tasks": [
    {
      "id": "T55500000.task.JR97L9E",
      "type": "payout_destination_backfill",
      "account_id": "P55500000",
      "status": "pending",
      "attempts": 1,
      "group_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "result": {},
      "error": {
        "code": "entity_mismatch",
        "message": "2 of 5 projections failed"
      },
      "updated_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z"
    }
  ],
  "starting_after": "T55500000.task.JR97L9E"
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

Authorization: Bearer {access_token}

where the access_token is JSON Web Tokens (JWT).

Path Parameters

oid

string<^[PT]{1}(?=(?:.{3}|.{8})$)[0-9]*$>

required

An id that uniquely identifies the account or owner (partner)

Query Parameters

task_id

string[]

Maximum array length: 100

Pattern: ^[PT]{1}\d{8}\.task\.[A-X1-9]{7,}$

type

string[]

Maximum array length: 10

account_id

string[]

Maximum array length: 100

Required string length: 9

Pattern: ^[PT]{1}\d{8}$

status

enum<string>[]

Maximum array length: 10

Available options:

pending,

processing,

completed,

failed

group_id

string

starting_after

string

cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, end the result contains paging_token=pt1, your subsequent call can include starting_after=pt1 in order to fetch the next page of the list.

limit

integer

default:10

A limit on the number of objects to be returned. Limit can range between 1 and 100 items, and the default is 10 items.

Required range: 1 <= x <= 100

Response

Collection of administrative tasks

tasks

object[]

required

Show child attributes

starting_after

string

Pattern: ^[PT]{1}\d{8}\.task\.[A-X1-9]{7,}$

Example:

"T55500000.task.JR97L9E"

Last modified on August 21, 2026

⌘I