1ClickImpact

Track

The Track API enables comprehensive environmental impact monitoring and real-time tracking for tree planting, ocean cleanup, carbon capture, and donation projects. This powerful endpoint delivers detailed progress tracking including geographic project locations, assigned nonprofit agents, completion verification, impact video documentation, live session scheduling, and donation flow monitoring throughout the complete environmental impact lifecycle.

Obtain the required tracking parameters (user_id and time_utc) from the /records endpoint for your organization's environmental impacts or the /customer_records endpoint for customer impact tracking. This sustainability API is ideal for building environmental transparency dashboards, ESG reporting features, impact verification systems, and providing stakeholders with real-time environmental contribution updates.

GET/v1/track

Track specific impact

This endpoint allows you to track the complete lifecycle and current status of a specific impact. It provides real-time tracking information including project location with maps, assigned agents, completion status, impact documentation, and live session details.

Required query params

  • Name
    user_id
    Type
    string
    Description

    The user ID of the person who made the impact. This can be your organization's user ID or a customer's user ID. You can obtain this from the /records or /customer_records API responses. The user_id should be in the format "U1234".

  • Name
    time_utc
    Type
    string
    Description

    The UTC timestamp when the impact was made. You can obtain this from the /records or /customer_records API responses. The time_utc should be in ISO 8601 format "YYYY-MM-DDTHH:mm:ss.sssZ".

Response fields

  • Name
    tracking_id
    Type
    string
    Description

    Unique identifier for tracking this specific impact record, formatted as user_id-time_utc.

  • Name
    impact_initiated
    Type
    string
    Description

    The time (in UTC) when the impact process was initiated.

  • Name
    donation_available
    Type
    string
    Description

    The time (in UTC) when the donation became available for the project. Only present when donation is received by 1ClickImpact.

  • Name
    donation_sent
    Type
    string
    Description

    The time (in UTC) when the donation was sent to the project. Only present when donation is transferred to a non-profit.

  • Name
    assigned_agent
    Type
    string
    Description

    Name of the agent or non-profit organization assigned to execute this impact. Only present when assigned.

  • Name
    project_location
    Type
    string
    Description

    Detailed description of the project location and implementing partners. Only present when available.

  • Name
    location_map
    Type
    string
    Description

    Google Maps embed URL for visualizing the project location. Only present when available.

  • Name
    impact_completed
    Type
    string
    Description

    The time (in UTC) when the impact was completed. Only present when completed.

  • Name
    donation_category
    Type
    string
    Description

    Describes what type of impact your donation funded (e.g., "planting food trees", "ocean cleanup"). Only appears for impacts created via the /donate_money API.

  • Name
    impact_video
    Type
    string
    Description

    URL to video recording or live session of the impact. Only present when available.

  • Name
    live_session_date
    Type
    string
    Description

    The time (in UTC) timestamp for scheduled live session related to this impact. Only present when sessions are scheduled.

  • Name
    is_test_transaction
    Type
    boolean
    Description

    Indicates whether this was a test transaction. Only present for test transactions.

  • Name
    is_bonus_impact
    Type
    boolean
    Description

    Indicates whether this was a bonus impact provided as part of subscription plans. Only present for bonus impacts.

Request

GET
/v1/track
curl --location 'https://api.1clickimpact.com/v1/track?user_id=U1234&time_utc=2025-03-12T15:22:14.753Z' \
--header 'x-api-key: {PRODUCTION API KEY}'

Response

{
  "tracking_id": "U1234-2025-03-12T15:22:14.753Z",
  "impact_initiated": "2025-03-12T15:22:14.753Z",
  "donation_available": "2025-03-22T23:44:02.121Z",
  "donation_sent": "2025-03-26T20:11:17.707Z",
  "assigned_agent": "Planting On Demand",
  "project_location": "Rwenzori Mountains, Uganda with Dream International.",
  "location_map": "https://www.google.com/maps/embed?pb=!1m14!1m8!1m3!1d4540132.650863914!2d30.710015055752173!3d0.37485976220513784!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x17617d0ff71884d7%3A0xb92785ca8b99bc36!2sRwenzori%20Mountains!5e1!3m2!1sen!2sus!4v1756229683367!5m2!1sen!2sus",
  "impact_completed": "2025-04-16T13:00:00.000Z",
  "impact_video": "https://meet.google.com/ynx-sgcq-dbd",
  "live_session_date": "2025-04-16T13:00:00.000Z"
}