Account Lists

Account Lists Documentation

Account List [LIST]

Account List [LIST]

Request

Endpoint

GET /api/v2/account_lists
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "14bd52cc-2eeb-4c67-95b7-3f2e807116d4",
      "type": "account_lists",
      "attributes": {
        "active_mpd_finish_at": null,
        "active_mpd_monthly_goal": null,
        "active_mpd_start_at": null,
        "balance": 0,
        "committed": 0,
        "created_at": "2022-01-12T17:18:50Z",
        "currency": null,
        "default_currency": "USD",
        "home_country": null,
        "last_prayer_letter_at": null,
        "monthly_goal": null,
        "name": "Shira ",
        "primary_appeal": null,
        "progress": {
          "monthly_goal": null,
          "in_hand_percent": null,
          "pledged_percent": null,
          "received_pledges": 0,
          "salary_balance": 0,
          "balance": 0,
          "total_pledges": 0
        },
        "received": 0,
        "salary_organization": "9041323d-8f93-483e-a740-2515e7c418db",
        "staff_account_ids": [

        ],
        "tester": null,
        "total_pledges": 0,
        "updated_at": "2022-01-12T17:18:50Z",
        "updated_in_db_at": "2022-01-12T17:18:50Z",
        "weeks_on_mpd": 0
      },
      "relationships": {
        "primary_appeal": {
          "data": null
        },
        "users": {
          "data": [
            {
              "id": "46993d03-089c-459c-9968-1e36926d5949",
              "type": "users"
            }
          ]
        },
        "coaches": {
          "data": [

          ]
        },
        "notification_preferences": {
          "data": [

          ]
        },
        "organization_accounts": {
          "data": [
            {
              "id": "4cd6d3e7-4773-44b3-a5b3-8638751a6435",
              "type": "organization_accounts"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_count": 1,
      "total_pages": 1
    },
    "sort": null,
    "filter": {
    }
  }
}

Fields

data

Type [Account List]

Description An array of Account Lists

Account List [GET]

Account List [GET]

Request

Endpoint

GET /api/v2/account_lists/90a43076-39fc-46ee-9529-cf9e753c1dc4
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "90a43076-39fc-46ee-9529-cf9e753c1dc4",
    "type": "account_lists",
    "attributes": {
      "active_mpd_finish_at": null,
      "active_mpd_monthly_goal": null,
      "active_mpd_start_at": null,
      "balance": 0,
      "committed": 0,
      "created_at": "2022-01-12T17:18:50Z",
      "currency": null,
      "default_currency": "USD",
      "home_country": null,
      "last_prayer_letter_at": null,
      "monthly_goal": null,
      "name": "Verlie ",
      "primary_appeal": null,
      "progress": {
        "monthly_goal": null,
        "in_hand_percent": null,
        "pledged_percent": null,
        "received_pledges": 0,
        "salary_balance": 0,
        "balance": 0,
        "total_pledges": 0
      },
      "received": 0,
      "salary_organization": "3fdb1471-fde3-41c8-a1e9-afb66a2d443d",
      "staff_account_ids": [

      ],
      "tester": null,
      "total_pledges": 0,
      "updated_at": "2022-01-12T17:18:50Z",
      "updated_in_db_at": "2022-01-12T17:18:50Z",
      "weeks_on_mpd": 0
    },
    "relationships": {
      "primary_appeal": {
        "data": null
      },
      "users": {
        "data": [
          {
            "id": "b5d79400-312b-4cf4-9637-edba7e886d94",
            "type": "users"
          }
        ]
      },
      "coaches": {
        "data": [

        ]
      },
      "notification_preferences": {
        "data": [

        ]
      },
      "organization_accounts": {
        "data": [
          {
            "id": "9669111d-08e4-471f-99d0-3ac40b8a6e51",
            "type": "organization_accounts"
          }
        ]
      }
    }
  }
}

Fields

Attributes

active_mpd_finish_at

Type string

Description The date when the account list users aim to finish MPD

active_mpd_monthly_goal

Type string

Description The monthly goal users of the account list are aiming to raise in the set period

active_mpd_start_at

Type string

Description The date when the account list users will start MPD

balance

Type float

Description The total converted balance of active designation accounts associated with this account list

committed

Type number

Description The monthly amount total pledged to the Account List

created_at

Type date

Description The timestamp of when this resource was created

currency

Type string

Description The currency code for the Account List, such as 'USD', 'CAD'

default_currency

Type string

Description The default currency code, 'USD'

home_country

Type string

Description The country of the Account List

last_prayer_letter_at

Type date

Description Date prayer letter last sent over MailChimp

monthly_goal

Type number

Description The monthly financial goal of the Account List

name

Type string

Description The name of the Account List

primary_appeal

Type Appeal

Description The appeal that is marked as primary

progress

Type object

Description Hash containing monthly_goal, in_hand_percent, pledged_percent, received_pledges, balance, total_pledges

received

Type number

Description The monthly amount total received to the Account List

salary_organization

Type string

Description The ID of the organization that is responsible for paying the user

staff_account_ids

Type ["string"]

Description Array of staff account ids on designation accounts for the Account List

tester

Type boolean

Description Whether or not the Account List is a testing account

total_pledges

Type float

Description The total amount of pledges donated for the Account List

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

weeks_on_mpd

Type number

Description Number of weeks since active_mpd_start_at if active_mpd_finish_at is after current date

Relationships

coaches.data

Type ["Person"]

Description collection of coaches who have access to the account list

notification_preferences.data

Type [Notification Preference]

Description An array of Notification Preference references for the Account List

organization_accounts.data

Type [Organization Account]

Description An array of Organization Accounts connected to the Account List

primary_appeal.data

Type Appeal

Description The appeal that is marked as primary

users.data

Type ["Person"]

Description collection of users who have access to the account list

Account List [PUT]

Account List [PUT]

Request

Endpoint

PUT /api/v2/account_lists/836f07e2-2d51-4bf9-b563-27124afc1b27
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "account_lists",
    "attributes": {
      "currency": "USD",
      "home_country": "United States",
      "monthly_goal": 4203,
      "name": "Green Group",
      "tester": false,
      "updated_in_db_at": "2022-01-12 17:18:50 UTC"
    }
  }
}

Parameters

Attributes

active_mpd_finish_at

Type string

Description The date when the account list users aim to finish MPD

Required No

active_mpd_monthly_goal

Type string

Description The monthly goal users of the account list are aiming to raise in the set period

Required No

active_mpd_start_at

Type string

Description The date when the account list users will start MPD

Required No

balance

Type float

Description The total converted balance of active designation accounts associated with this account list

Required No

committed

Type number

Description The monthly amount total pledged to the Account List

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

currency

Type string

Description The currency code for the Account List, such as 'USD', 'CAD'

Required No

home_country

Type string

Description The country of the Account List

Required No

last_prayer_letter_at

Type date

Description Date prayer letter last sent over MailChimp

Required No

monthly_goal

Type number

Description The monthly financial goal of the Account List

Required No

name

Type string

Description The name of the Account List

Required No

overwrite

Type boolean

Description Only used for updating a record where you want to ignore the server's ' 'updated_in_db_at value and force overwrite the values for the record. ' 'Must be true to work.

Required No

primary_appeal

Type Appeal

Description The appeal that is marked as primary

Required No

progress

Type object

Description Hash containing monthly_goal, in_hand_percent, pledged_percent, received_pledges, balance, total_pledges

Required No

received

Type number

Description The monthly amount total received to the Account List

Required No

salary_organization

Type string

Description The ID of the organization that is responsible for paying the user

Required No

staff_account_ids

Type ["string"]

Description Array of staff account ids on designation accounts for the Account List

Required No

tester

Type boolean

Description Whether or not the Account List is a testing account

Required No

total_pledges

Type float

Description The total amount of pledges donated for the Account List

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

weeks_on_mpd

Type number

Description Number of weeks since active_mpd_start_at if active_mpd_finish_at is after current date

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "836f07e2-2d51-4bf9-b563-27124afc1b27",
    "type": "account_lists",
    "attributes": {
      "active_mpd_finish_at": null,
      "active_mpd_monthly_goal": null,
      "active_mpd_start_at": null,
      "balance": 0,
      "committed": 0,
      "created_at": "2022-01-12T17:18:50Z",
      "currency": "USD",
      "default_currency": "USD",
      "home_country": "United States",
      "last_prayer_letter_at": null,
      "monthly_goal": 4203,
      "name": "Green Group",
      "primary_appeal": null,
      "progress": {
        "monthly_goal": 4203,
        "in_hand_percent": 0,
        "pledged_percent": 0,
        "received_pledges": 0,
        "salary_balance": 0,
        "balance": 0,
        "total_pledges": 0
      },
      "received": 0,
      "salary_organization": "74f0c1be-11ac-47e7-9c14-1aa2011be035",
      "staff_account_ids": [

      ],
      "tester": false,
      "total_pledges": 0,
      "updated_at": "2022-01-12T17:18:50Z",
      "updated_in_db_at": "2022-01-12T17:18:50Z",
      "weeks_on_mpd": 0
    },
    "relationships": {
      "primary_appeal": {
        "data": null
      },
      "users": {
        "data": [
          {
            "id": "47b5dd6c-b298-4c69-bb18-fc16dcca74d9",
            "type": "users"
          }
        ]
      },
      "coaches": {
        "data": [

        ]
      },
      "notification_preferences": {
        "data": [

        ]
      },
      "organization_accounts": {
        "data": [
          {
            "id": "187102a8-bdf2-4cdc-9a0c-24a7988df470",
            "type": "organization_accounts"
          }
        ]
      }
    }
  }
}

Fields

Attributes

active_mpd_finish_at

Type string

Description The date when the account list users aim to finish MPD

active_mpd_monthly_goal

Type string

Description The monthly goal users of the account list are aiming to raise in the set period

active_mpd_start_at

Type string

Description The date when the account list users will start MPD

balance

Type float

Description The total converted balance of active designation accounts associated with this account list

committed

Type number

Description The monthly amount total pledged to the Account List

created_at

Type date

Description The timestamp of when this resource was created

currency

Type string

Description The currency code for the Account List, such as 'USD', 'CAD'

default_currency

Type string

Description The default currency code, 'USD'

home_country

Type string

Description The country of the Account List

last_prayer_letter_at

Type date

Description Date prayer letter last sent over MailChimp

monthly_goal

Type number

Description The monthly financial goal of the Account List

name

Type string

Description The name of the Account List

primary_appeal

Type Appeal

Description The appeal that is marked as primary

progress

Type object

Description Hash containing monthly_goal, in_hand_percent, pledged_percent, received_pledges, balance, total_pledges

received

Type number

Description The monthly amount total received to the Account List

salary_organization

Type string

Description The ID of the organization that is responsible for paying the user

staff_account_ids

Type ["string"]

Description Array of staff account ids on designation accounts for the Account List

tester

Type boolean

Description Whether or not the Account List is a testing account

total_pledges

Type float

Description The total amount of pledges donated for the Account List

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

weeks_on_mpd

Type number

Description Number of weeks since active_mpd_start_at if active_mpd_finish_at is after current date

Relationships

coaches.data

Type ["Person"]

Description collection of coaches who have access to the account list

notification_preferences.data

Type [Notification Preference]

Description An array of Notification Preference references for the Account List

organization_accounts.data

Type [Organization Account]

Description An array of Organization Accounts connected to the Account List

primary_appeal.data

Type Appeal

Description The appeal that is marked as primary

users.data

Type ["Person"]

Description collection of users who have access to the account list