Skip to contentSkip to navigationSkip to topbar
Twilio Docs

Get Import Status

(information)

Legal information

Conversation Memory, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum(link takes you to an external page). For more details on AI usage and data, see the AI Nutrition Facts.

Conversation Memory is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

Conversation Memory is not intended for use with sensitive information about individuals. Twilio does not control what information comes from conversation channels and relies on you to ensure the data in customer profiles aligns with our acceptable use policy. Twilio does have limited guardrails in the form of a prompt exclusion that is designed to provide a minimal screening against inclusion of GDPR special category data(link takes you to an external page). As a reminder our profile technology uses generative artificial intelligence. Because generative artificial intelligence can make mistakes, review all outputs to ensure that the profile is correct.

Conversations products are only available in the new Twilio Console(link takes you to an external page). If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

GET/v1/Stores/{storeId}/Profiles/Imports/{importId}

Base url: https://memory.twilio.com (base url)

Retrieve the current processing status of a previously submitted bulk import task. Query this endpoint using the importId returned from the upload URL request until a terminal state (COMPLETED or FAILED) is reached.

Request

fetch-profile-import-v2-request page anchor

Authentication

authentication page anchor

Path parameters

fetch-profile-import-v2-path-parameters page anchor
Property nameTypeRequiredPIIDescription
storeIdstring
required
Not PII

A unique Memory Store ID using Twilio Type ID (TTID) format

Example: mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$
importIdstring
required
Not PII

The task identifier for the import process.

Pattern: ^mem_import_[0-7][0-9a-z]{25}$

Responses

fetch-profile-import-v2-responses page anchor
200400401403404429500503

Import Status.

Schema
Property nameTypeRequiredPIIDescriptionChild properties
statusenum<string>

Optional

Not PII

Current processing status of the import task

Possible values:
PENDINGPROCESSINGCOMPLETEDFAILED
filenamestring

Optional

Not PII

Original filename of the uploaded CSV

Example: profiles_import.csvMax length: 255
createdAtstring<date-time>

Optional

Not PII

Timestamp when the import was created

Example: 2025-11-14T20:29:21Z
updatedAtstring<date-time>

Optional

Not PII

Timestamp when the import was last updated

Example: 2025-11-14T20:30:15Z
fileSizeinteger

Optional

Not PII

Size of the uploaded file in bytes (1 byte to 100 MiB)

Example: 204800Minimum: 1Maximum: 104857600
columnMappingsarray[object]

Optional

Not PII

Mappings of CSV header columns to traits' fields

Min items: 2Max items: 100
summaryobject

Optional

Not PII

Summary statistics of the import operation

Get Import StatusLink to code sample: Get Import Status
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function fetchProfileImportV2() {

11
  const import_ = await client.memory.v1

12
    .imports(

13
      "mem_store_00000000000000000000000000",

14
      "mem_import_01111111111111111111111111"

15
    )

16
    .fetch();

17


18
  console.log(import_.status);

19
}

20


21
fetchProfileImportV2();

Response

Note about this response
1
{

2
  "columnMappings": [

3
    {

4
      "columnName": "columnName",

5
      "traitGroup": "traitGroup",

6
      "traitName": "traitName"

7
    }

8
  ],

9
  "createdAt": "2009-07-06T20:30:00Z",

10
  "fileSize": 204800,

11
  "filename": "filename",

12
  "status": "PENDING",

13
  "summary": {

14
    "errors": 10,

15
    "warnings": 5

16
  },

17
  "updatedAt": "2009-07-06T20:30:00Z"

18
}