Global.Church Developer Portal
Global.Church API

Commitments

Endpoint:https://api.global.church

List commitments

GET
https://api.global.church
/v0/commitments

Returns gc:FulfillmentCommitment instances from GraphDB (https://data.global.church/commitments/). Optional filters: orgUri, status, concernsNeedId, limit.

List commitments › query Parameters

  • orgUristring

    Filter by committing organization URI.

  • statusstring · enum

    Filter by commitment status.

    Enum values:
    declared
    funded
    in_progress
    fulfilled
    partially_fulfilled
    abandoned
    expired
  • concernsNeedIdstring · uuid

    Filter by the UUID of the need this commitment is linked to.

  • limitinteger · min: 1 · max: 200

    Max rows to return (default 50, max 200).

List commitments › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List commitments › Responses

List of commitments

  • commitmentsobject[] · required
  • totalinteger · required

Submit commitment

POST
https://api.global.church
/v0/commitments

Creates a new gc:FulfillmentCommitment for an organization, optionally linked to a prior gc:Need. Caller must have an active org membership.

Submit commitment › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Submit commitment › Request Body

  • orgUristring · required

    GraphDB URI of the committing organization

  • orgNamestring · required

    Display name of the organization

  • declaredByEmailstring · email · required
  • commitmentDescriptionstring · required
  • acceleratorScopestring[] · minItems: 1 · required

    Engagement accelerator or function notation codes.

  • concernsNeedIdstring · uuid

    Optional — UUID of a gc:Need this commitment is responding to.

  • concernsPeopleGroupRop3string[]
  • concernsCountryCodestring[]
  • targetCompletionDatestring · date

    Optional ISO YYYY-MM-DD target completion date.

Submit commitment › Responses

Commitment created

  • commitmentIdstring · uuid · required
  • statusstring · enum · required
    Enum values:
    declared

CORS preflight for commitments

OPTIONS
https://api.global.church
/v0/commitments

CORS preflight for commitments › Responses

No content

No data returned

Update commitment status

POST
https://api.global.church
/v0/commitments/status

Transitions a gc:FulfillmentCommitment between declared / funded / in_progress / fulfilled / partially_fulfilled / abandoned / expired. Caller must have an active membership (or approved org_claim) for the commitment's owning org. No state-machine enforcement — any status is reachable from any status.

Update commitment status › Headers

  • Authorizationstring · required

    The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Update commitment status › Request Body

  • commitmentIdstring · uuid · required
  • statusstring · enum · required
    Enum values:
    declared
    funded
    in_progress
    fulfilled
    partially_fulfilled
    abandoned
    expired
  • actorEmailstring · email · required

    Email of the user making the status change.

Update commitment status › Responses

Status updated

  • commitmentIdstring · uuid · required
  • statusstring · required

CORS preflight for commitment status

OPTIONS
https://api.global.church
/v0/commitments/status

CORS preflight for commitment status › Responses

No content

No data returned
NeedsUUPG+ Lists