IwiConnect API docs

Reference

Enumerations

Every fixed value the API accepts or returns, in one place. Send the code, not the label. Labels are what the portal displays and they change without notice; codes do not.

Project types

The type you choose decides which phases are valid and what priority the project carries when it lands.

CodeLabelPriority
EMERGENCY_WORKSEmergency WorksHIGH
ENVIRONMENTAL_SPILL_HEALTH_INCIDENTEnvironmental Spill / Health IncidentHIGH
ACCIDENTAL_DISCOVERYAccidental DiscoveryHIGH
LAND_USE_CONSENTLand Use ConsentMEDIUM
SUBDIVISION_CONSENTSubdivision ConsentMEDIUM
DISCHARGE_CONSENT_APPLICATIONDischargeMEDIUM
WATER_TAKE_CONSENTWater Take ConsentMEDIUM
COASTAL_STREAM_CONSENTCoastal and/or Stream ConsentMEDIUM
POLICY_OR_POLICY_CHANGEPolicyMEDIUM
PLAN_CHANGEPlan ChangeMEDIUM
DESIGNATIONS_NOTICES_OF_REQUIREMENTDesignations / Notices of RequirementMEDIUM
INFRASTRUCTURE_DEVELOPMENTInfrastructure DevelopmentMEDIUM
ARCHAEOLOGICAL_AUTHORITYArchaeological AuthorityMEDIUM
RENEWABLE_ENERGYRenewable EnergyMEDIUM
SITE_WORKS_STARTSite Works StartLOW
CULTURAL_MONITORINGCultural MonitoringLOW
BUILDING_OPENINGBuilding OpeningLOW
TREE_CONSENTTree ConsentLOW
CONSERVATIONConservationLOW
SCHEDULED_MAINTENANCEScheduled MaintenanceLOW
EARTHWORKSEarthworksMEDIUM
OTHEROtherMEDIUM

Project phases

Phases are grouped. A works type only accepts works phases, a consent type only accepts consent phases, and policy types have their own longer sequence. Sending a phase outside the group for the type returns 400.

CodeLabelValid for
PRE_STARTPre-startworks
WORKS_UNDERWAYWorks underwayworks
COMPLETECompleteworks
PRE_LODGEMENTPre-lodgementconsent, policy
LODGEDLodgedconsent, policy
FURTHER_INFORMATION_REQUESTEDFurther information requestedconsent, policy
ACCEPTANCE_DECISIONAcceptance decisionpolicy
NOTIFICATIONNotificationconsent, policy
SUBMISSIONSSubmissionsconsent, policy
FURTHER_SUBMISSIONSFurther submissionspolicy
HEARINGHearingconsent, policy
DECISIONDecisionconsent, policy
APPEALAppealconsent, policy
OPERATIVEOperativepolicy
ON_HOLDOn Holdconsent, policy
WITHDRAWNWithdrawnconsent, policy

Project status

Status is set by the platform as the project moves. You do not send it.

CodeMeaning
DRAFTCreated, not sent, not billed.
NEWSent, not yet opened by the iwi.
AWAITING_RESPONSEPicked up on the iwi side, no reply yet.
IN_PROGRESSKōrero underway.
UPDATEDNew activity since you last looked.
COMPLETEEngagement finished.
CLOSEDClosed off.

Priority

CodeApplies to
HIGHEmergency works, environmental spills and health incidents, accidental discovery.
MEDIUMConsents, policy and plan changes, infrastructure, earthworks, renewable energy, other.
LOWSite works start, cultural monitoring, building openings, tree consents, conservation, scheduled maintenance.

Priority is derived from the type. There is no field to set or override it.

Meeting types

Used on notes to record how an interaction happened.

CodeLabel
PHONE_CALLPhone Call
VIDEO_CALLVideo Call
IN_PERSONIn-person
EMAILEmail
OTHEROther

Log actions and resources

Entries in GET /projects/{id}/logs carry an action and the resource it applied to.

ActionResource
CREATED, UPDATED, DELETED, RESPONDED, SENT, REOPENED, CLOSED, COMPLETEDPROJECT, TEAM

User roles

CodeCan do
OWNERManage the team, its people and its billing, on top of everything a member can do.
MEMBERWork on projects, notes and groups.

Invitation status

CodeMeaning
PENDINGSent, not yet acted on.
ACCEPTEDAccepted. The person is now a member.
EXPIREDLapsed or cancelled. Resending creates a fresh window.

Upload categories

CodeAccepted extensions
document.pdf, .doc, .docx, .jpg, .jpeg, .png
image.png, .jpg, .jpeg, .webp
gisLayer.geojson, .json, .kml, .zip, .topojson

Bulk invite results

CodeMeaning
INVITEDInvitation sent.
SKIPPEDAlready a member or already invited. Not an error.
FAILEDThe row could not be processed. See message.

New values get added. Project types and phases grow as the platform covers more kinds of work. Treat an unrecognised code as a value you display verbatim rather than something that should crash a parser.