---
title: "API: Import Data Values"
description: Importing data values to Clear Impact Scorecard using the API.
---

[Skip to content](https://support.clearimpact.com/en/2023-api-import-data-values#main-content)

English

Show submenu for translations

[Contact Support](https://support.clearimpact.com/en/kb-tickets/new?hsLang=en)

[![Clear-Impact-Logo-Wide-Tagline-RGB.png\]](https://support.clearimpact.com/hs-fs/hubfs/images/Clear-Impact-Logo-Wide-Tagline-RGB.png?height=40&name=Clear-Impact-Logo-Wide-Tagline-RGB.png)](https://support.clearimpact.com/?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact Support](https://support.clearimpact.com/en/kb-tickets/new)
- [Help Desk](https://support.clearimpact.com/en/kb-tickets/new)

[Help Desk](https://support.clearimpact.com/en/kb-tickets/new?hsLang=en)

 Hi, how can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.clearimpact.com/en?hsLang=en)
2. [Scorecard Documentation](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en)
3. [API](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#api)

# API: Import Data Values

### Explanation of Import Data Value Parameters

- id \[int\](Required) - The unique Clear Impact Scorecard ID for the measure that data values are being imported into. Measure IDs can be found by downloading the [measure list](https://support.clearimpact.com/en/2023-indicator-program-measure-or-variable-lists?hsLang=en).
- actualValue \[decimal\] (Optional) - Integer data value for the actual value, up to 6 decimals
- targetValue \[decimal\] (Optional) - Integer data value for the target value, up to 6 decimals
- actualValueDate \[dateTime\] (Required) - Determines the time period to import the data value for, expressed as YYYY-MM-DD. To import values for a specific time period, use a date anywhere within that time period. For example, March 2013 runs from 2013-03-01 through 2013 - 03 - 31. So you can enter any date within this period, such as 2013-03-15.
- comment \[string\] (Optional) - Comment for the data value, up to 255 characters (will be truncated after 255)

### Data Import API Tips

- Dates must entered as YYYY-MM-DD.
- For % or $ metrics, do not include the symbols.
- For % use the actual number, not a decimal (i.e. 90% should be entered as 90).
- For each value that exists in the import, a new one will be created in Clear Impact Scorecard.
- If a value already exists for a measure and time period, the value will be overwritten with what is in the payload, unless it is left blank.

### Troubleshooting

The data values module has a few additional parameter requirements that may cause the import to fail, usually with an Error 304 (Not Modified).

- You may only import one actual value into a single time period per import. If two of your data value parameters have the same date, or are within the same time period date range for a measure, the import will fail. For example, for an annual measure, the dates of 2014-01-01 and 2014-06-01 fall within the same time period. So if you have two data value parameters with these dates, the import will fail.
- You cannot import data into [calculated measures](https://support.clearimpact.com/en/2023-creating-custom-calculations?hsLang=en) (indicators or performance measures with a calculationId != 1).

**URL**

```
https://api.resultsscorecard.com/api/datavalues/import
```

**JSON Input**

```
{  "siteCode": "abc",  "apiKey": "eEIzvy0kCu017+D1VjjjI1f52Vmbm+VF2FvO",  "values": [    {      "ID": 26050,      "actualValueDate": "2013-11-20T17:09:34.8550556Z",      "targetValue": 41598.381653414,      "actualValue": 1,      "comment": "comment: 0"    },    {      "ID": 26050,      "measureType": "i",      "actualValueDate": "2013-11-20T17:09:34.8550556Z",      "targetValue": 41598.381653414,      "actualValue": 1,      "comment": "comment: 1"    },    {	      "ID": 26050,      "actualValueDate": "2013-11-20T17:09:34.8550556Z",      "targetValue": 41598.381653414,      "actualValue": 1,      "comment": "comment: 2"    }  ]}
```

**JSON Output**

```
"Import successful."
```

- [Scorecard Documentation](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#main-content)

    - [Getting Started](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#getting-started)
    - [Scorecards](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#scorecards)
    - [Scorecard Objects](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#scorecard-objects)
    - [Entering Scorecard Data and Notes](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#entering-scorecard-data-and-notes)
    - [Viewing or Editing Scorecard Objects and Data](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#viewing-or-editing-scorecard-objects-and-data)
    - [Actions](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#actions)
    - [Reports](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#reports)
    - [Tools](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#tools)
    - [Site-Level Settings](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#site-level-settings)
    - [API](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#api)
    - [Upgrade Notes](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#upgrade-notes)
    - [FAQ (Scorecard)](https://support.clearimpact.com/en/scorecard-documentation?hsLang=en#faq-scorecard)
- [Scorecard Video Tutorials](https://support.clearimpact.com/en/scorecard-video-tutorials?hsLang=en#main-content)

    - [Upgrade Videos](https://support.clearimpact.com/en/scorecard-video-tutorials?hsLang=en#upgrade-videos)
    - [Training Videos](https://support.clearimpact.com/en/scorecard-video-tutorials?hsLang=en#training-videos)
    - [Customer Success Stories](https://support.clearimpact.com/en/scorecard-video-tutorials?hsLang=en#customer-success-stories)
- [Compyle Documentation](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#main-content)

    - [Compyle Overview](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#compyle-overview)
    - [Participants, Households, and Organizations](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#participants-households-and-organizations)
    - [Data Collection](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#data-collection)
    - [Analytics](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#analytics)
    - [Administration](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#administration)
    - [Administration - Forms and Fields](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#administration-forms-and-fields)
    - [Scorecard Feeds](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#scorecard-feeds)
    - [Compyle Release Notes](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#compyle-release-notes)
    - [FAQ (Compyle)](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#faq-compyle)
    - [Referral Network (Compyle-to-Compyle Referrals)](https://support.clearimpact.com/en/compyle-documentation?hsLang=en#referral-network-compyle-to-compyle-referrals)
- [Compyle Video Tutorials](https://support.clearimpact.com/en/compyle-video-tutorials?hsLang=en#main-content)

    - [Compyle Overview Videos](https://support.clearimpact.com/en/compyle-video-tutorials?hsLang=en#compyle-overview-videos)
    - [Upgrade Webinars](https://support.clearimpact.com/en/compyle-video-tutorials?hsLang=en#upgrade-webinars)
- [Control Documentation](https://support.clearimpact.com/en/control-documentation?hsLang=en#main-content)

    - [Control Overview](https://support.clearimpact.com/en/control-documentation?hsLang=en#control-overview)
    - [Control for Users](https://support.clearimpact.com/en/control-documentation?hsLang=en#control-for-users)
    - [Control for Administrators](https://support.clearimpact.com/en/control-documentation?hsLang=en#control-for-administrators)
    - [Control FAQ](https://support.clearimpact.com/en/control-documentation?hsLang=en#control-faq)
    - [Clear Impact Suite Overview](https://support.clearimpact.com/en/control-documentation?hsLang=en#clear-impact-suite-overview)
    - [Suite Release Notes](https://support.clearimpact.com/en/control-documentation?hsLang=en#suite-release-notes)
- [Showcase Documentation](https://support.clearimpact.com/en/showcase-documentation?hsLang=en)
- [Unlimited Suite Documentation](https://support.clearimpact.com/en/unlimited-suite-documentation?hsLang=en#main-content)

    - [Suite Implementation Materials](https://support.clearimpact.com/en/unlimited-suite-documentation?hsLang=en#suite-implementation-materials)
    - [Managing Partner/Child Sites](https://support.clearimpact.com/en/unlimited-suite-documentation?hsLang=en#managing-partner-child-sites)
    - [Rolling Up Data Across the Unlimited Suite Network](https://support.clearimpact.com/en/unlimited-suite-documentation?hsLang=en#rolling-up-data-across-the-unlimited-suite-network)
- [Clear Impact Live Training](https://support.clearimpact.com/en/clear-impact-live-training?hsLang=en#main-content)

    - [Free and Customized Training](https://support.clearimpact.com/en/clear-impact-live-training?hsLang=en#free-and-customized-training)
    - [Software Courses](https://support.clearimpact.com/en/clear-impact-live-training?hsLang=en#software-courses)
- [Collaborate with Clear Impact](https://support.clearimpact.com/en/collaborate-with-clear-impact?hsLang=en#main-content)

    - [Coming Attractions & Sneak Peeks](https://support.clearimpact.com/en/collaborate-with-clear-impact?hsLang=en#coming-attractions-sneak-peeks)
    - [Resources & Results](https://support.clearimpact.com/en/collaborate-with-clear-impact?hsLang=en#resources-results)

[![Logo\_ClearImpact\_White](https://support.clearimpact.com/hs-fs/hubfs/Logo_ClearImpact_White.png?width=341&height=80&name=Logo_ClearImpact_White.png "Logo_ClearImpact_White")](http://www.clearimpact.com)

Clear Impact Help Center | support@clearimpact.com

<https://www.linkedin.com/company/clear-impact-llc/posts/?feedView=all> <https://clearimpact.com/resources/turning-curves-podcast/> <https://clearimpact.com/social-sector-hero/>

Copyright © 2025, Clear Impact, Inc. LLC.