List a case's extraction codes

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

Close
GET /case/{caseId}/extraction

Lists the case's extraction codes (the codes custodians use to share data from their devices) with their upload status and, on cases shared with opposing counsel, their review status.

Headers

  • organization string Required

    id of the selected (active) organization

Path parameters

  • caseId string Required

    Id of the case

Query parameters

  • page number

    Default value is 1.

  • perPage number

    Default value is 10.

  • skip number

    If skip/limit not provided, page/perPage will take precedence

  • limit number

    If skip/limit not provided, page/perPage will take precedence

  • sortOrder string

    Values are asc or desc. Default value is asc.

  • skipPagination number

    0 false, 1 true

  • searchText string

    Minimum length is 3, maximum length is 100.

  • extractionCode string

    Maximum length is 100.

  • sortBy string

    Values are createdAt or updatedAt. Default value is updatedAt.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • total number Required
      • page number
      • perPage number
      • skip number
      • limit number
      • totalPages number Required
      • nextPage number | null Required
      • previousPage number | null Required
      • data array[object]
        Hide data attributes Show data attributes object
        • createdAt string(date-time) Required
        • updatedAt string(date-time) Required
        • id string Required
        • code string Required
        • email string Required
        • name string | null Required
        • phone string | null Required
        • isActive boolean Required
        • label string | null Required
        • config object Required
          Hide config attributes Show config attributes object
          • type string Required

            Values are allow_client, share_all, or auto_share. Default value is allow_client.

          • origin string | null Required
          • ignoreMediaPermissionAndroid boolean
          • dateRange object
            Hide dateRange attributes Show dateRange attributes object
            • start string(date-time) | null Required
            • end string(date-time) | null Required
          • appConfig object
            Hide appConfig attributes Show appConfig attributes object
            • conversionConcurrency array[object] Required
              Hide conversionConcurrency attributes Show conversionConcurrency attributes object
              • mediaType string Required

                Values are images, video, audio, or documents.

              • concurrency array[number] Required
            • compressionConcurrency array[object] Required
              Hide compressionConcurrency attributes Show compressionConcurrency attributes object
              • mediaType string Required

                Values are images, video, audio, or documents.

              • concurrency array[number] Required
            • enableLocalMediaConversion boolean
            • enableLocalMediaCompression boolean
            • enableIosEncryptedBackupExtraction boolean
            • allowOnlyEncryptedIosBackup boolean
            • autoIncludeSafariData boolean
            • autoIncludeNotesData boolean
            • autoIncludeContacts boolean

              Default value is false.

            • shareAction string

              Values are share, export, or share_and_export. Default value is share.

          • enableLocalExport object
            Hide enableLocalExport attributes Show enableLocalExport attributes object
            • formats array[string]
            • defaultConfig object
              Hide defaultConfig attributes Show defaultConfig attributes object
              • chunkType string Required

                Values are year, month, week, day, or none.

              • includeAttachments boolean Required
          • allowClient object
            Hide allowClient attributes Show allowClient attributes object
            • allowSocialApps array[string] Required
            • allowShareAll boolean Required
          • autoShare object
            Hide autoShare attributes Show autoShare attributes object
            • allowClientApproval boolean Required
            • allowAdditionalShare boolean Required
            • searches array[object] Required
              Hide searches attributes Show searches attributes object
              • type string Required

                Values are name, phone, keywords, or email. Default value is name.

              • values array[string] Required
              • apps array[string] Required
              • dateRange object Required
                Hide dateRange attributes Show dateRange attributes object
                • start string(date-time) | null Required
                • end string(date-time) | null Required
              • exactMatch boolean Required
              • include boolean Required
              • conversationType string Required

                Values are all, dm, or group. Default value is all.

          • shareAll object
            Hide shareAll attributes Show shareAll attributes object
            • apps array[string] Required
            • includeAttachments boolean Required
            • dateRange object
              Hide dateRange attributes Show dateRange attributes object
              • start string(date-time) | null Required
              • end string(date-time) | null Required
            • searchesExclude array[object]
              Hide searchesExclude attributes Show searchesExclude attributes object
              • type string Required

                Values are name, phone, keywords, or email. Default value is name.

              • values array[string] Required
              • apps array[string] Required
              • exactMatch boolean Required
              • conversationType string Required

                Values are all, dm, or group. Default value is all.

        • devices array[object] | null Required

          Not loaded by any route, so always null or an empty list.

        • totalDevicesCount number Required
        • dueDate string(date-time) | null
        • sendEmail boolean

          Default value is false.

        • lockedAt string(date-time) | null
        • hasDueDateCrossed boolean Required
        • status string Required
        • reviewStatus string | null Required

          Values are approved, rejected, not_reviewed, or na.

        • reviewMessage string | null Required
        • lastApprovedBy object Required

          The full record on routes that load it; null (or an empty list) on routes that do not.

          Hide lastApprovedBy attributes Show lastApprovedBy attributes object
          • createdAt string(date-time) Required
          • updatedAt string(date-time) Required
          • id string Required
          • name string Required
          • email string Required
          • phone array[string] Required
          • isActive boolean Required
          • isEmailVerified boolean Required
          • lastActive string(date-time) Required
          • roles array[string] Required
          • avatar object Required

            The full record on routes that load it; null (or an empty list) on routes that do not.

            Hide avatar attributes Show avatar attributes object
            • createdAt string(date-time) Required
            • updatedAt string(date-time) Required
            • id string Required
            • name string Required
            • providerId string Required
            • convertedName string | null Required
            • convertedProviderId string Required
            • provider string Required
            • size number Required

              Size in bytes

            • transferState number | null Required
          • onboardingStatus string | null Required
          • userType string | null Required
          • firstName string Required
          • lastName string Required
          • initials string Required
          • userOrganizations array[object]

            Only filled on the signed-in user's own profile; absent or empty on a user nested in another record.

        • ocReviewedByOrg object Required

          The full record on routes that load it; null (or an empty list) on routes that do not.

          Hide ocReviewedByOrg attributes Show ocReviewedByOrg attributes object
          • createdAt string(date-time) Required
          • updatedAt string(date-time) Required
          • id string Required
          • name string Required
          • slug string Required
          • email string Required
          • contact string Required
          • city string Required
          • state string Required
          • country string Required
          • description string Required
          • phone array[string] Required
          • isActive boolean Required
          • isPriority boolean
          • activePlan object Required

            The full record on routes that load it; null (or an empty list) on routes that do not.

            Hide activePlan attributes Show activePlan attributes object
            • createdAt string(date-time) Required
            • updatedAt string(date-time) Required
            • id string Required
            • subscription object | null Required

              Not loaded on public routes, so always null there. Only the internal admin organization report loads it.

            • relatedSubscription array[object] | null Required

              Not loaded by any route, so always null or an empty list.

            • organization object | null Required

              Not loaded by any route, so always null.

            • seats number Required
            • seatsUsed number Required
            • devices number Required
            • deviceUsed number Required
            • storage number Required

              Storage in bytes

            • storageUsed number Required

              Storage used in bytes

            • payments array[object] | null Required

              Not loaded by any route, so always null or an empty list.

            • type string Required

              Values are admin, free, limited-access, trial, tier1, tier2, tier3, tier4, tier5, tier6, or tier7.

            • isActive boolean Required
            • isBetweenPlanChanges boolean Required
            • storageInKb number Required
            • storageUsedInKb number Required
            • storageInMb number Required
            • storageUsedInMb number Required
            • storageInGb number Required
            • storageUsedInGb number Required
            • storageInTb number Required
            • storageUsedInTb number Required
            • isFreePlan boolean Required
            • remainingSeats number Required
            • remainingDevices number Required
            • remainingStorage number Required

              Storage left in bytes (storage minus storageUsed).

          • metadata object Required
          • type string Required
          • version string Required

            Values are v1, v2, eu, or ca.

        • ocReviewedAt string(date-time) | null Required
        • ocRequired boolean Required

          Default value is true.

        • allowShareAll boolean Required Deprecated
        • metadata object Required
        • logsConfig object Required
        • sources array[object]
          Hide sources attributes Show sources attributes object
          • createdAt string(date-time) Required
          • updatedAt string(date-time) Required
          • id string Required
          • case object | null Required

            Not loaded by any route, so always null.

          • extractionCode object | null Required

            Not loaded by any route, so always null.

          • dataSource object Required

            The full record on routes that load it; null (or an empty list) on routes that do not.

            Hide dataSource attributes Show dataSource attributes object
            • createdAt string(date-time) Required
            • updatedAt string(date-time) Required
            • id string Required
            • name string Required
            • displayName string Required
            • category string Required
            • config object | null Required

              Collection options for this source. The keys below are the ones the code reads, for device sources (ios, android).

              Additional properties are allowed.

              Hide config attributes Show config attributes object | null
              • iosEnableEncryptedBackup boolean
              • iosAllowOnlyEncryptedBackup boolean
              • iosAutoIncludeSafariData boolean
              • iosAutoIncludeNotesData boolean
              • androidIgnoreMediaPermission boolean
              • iosAllApps array[string]
              • iosAllowedApps array[string]
              • androidAllApps array[string]
              • androidAllowedApps array[string]
          • caseDataSource object Required

            The full record on routes that load it; null (or an empty list) on routes that do not.

            Hide caseDataSource attributes Show caseDataSource attributes object
            • createdAt string(date-time) Required
            • updatedAt string(date-time) Required
            • id string Required
            • case object | null Required

              Not loaded by any route, so always null.

            • dataSource object Required

              The full record on routes that load it; null (or an empty list) on routes that do not.

              Hide dataSource attributes Show dataSource attributes object
              • createdAt string(date-time) Required
              • updatedAt string(date-time) Required
              • id string Required
              • name string Required
              • displayName string Required
              • category string Required
              • config object | null Required

                Collection options for this source. The keys below are the ones the code reads, for device sources (ios, android).

                Additional properties are allowed.

                Hide config attributes Show config attributes object | null
                • iosEnableEncryptedBackup boolean
                • iosAllowOnlyEncryptedBackup boolean
                • iosAutoIncludeSafariData boolean
                • iosAutoIncludeNotesData boolean
                • androidIgnoreMediaPermission boolean
                • iosAllApps array[string]
                • iosAllowedApps array[string]
                • androidAllApps array[string]
                • androidAllowedApps array[string]
            • config object | null Required
          • config object | null Required
        • payment object | null Required
    • statusCode number Required
    • timestamp string(date-time) Required
GET /case/{caseId}/extraction
curl \
 --request GET 'http://api.example.com/case/{caseId}/extraction' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200)
{
  "data": {
    "total": 42,
    "page": 1,
    "perPage": 20,
    "skip": 0,
    "limit": 20,
    "totalPages": 3,
    "nextPage": 2,
    "previousPage": 42.0,
    "data": [
      {
        "createdAt": "2026-01-15T14:30:00.000Z",
        "updatedAt": "2026-01-15T14:30:00.000Z",
        "id": "507f1f77bcf86cd799439011",
        "code": "K7Q2-9XPL",
        "email": "jane.doe@example.com",
        "name": "Jane Doe",
        "phone": "+15555550100",
        "isActive": true,
        "label": "Primary phone",
        "config": {
          "type": "allow_client",
          "origin": "Website",
          "ignoreMediaPermissionAndroid": false,
          "dateRange": {
            "start": "2026-05-04T09:42:00Z",
            "end": "2026-05-04T09:42:00Z"
          },
          "appConfig": {
            "conversionConcurrency": [
              {
                "mediaType": "images",
                "concurrency": [
                  4,
                  6,
                  12,
                  16
                ]
              }
            ],
            "compressionConcurrency": [
              {
                "mediaType": "images",
                "concurrency": [
                  4,
                  6,
                  12,
                  16
                ]
              }
            ],
            "enableLocalMediaConversion": true,
            "enableLocalMediaCompression": true,
            "enableIosEncryptedBackupExtraction": false,
            "allowOnlyEncryptedIosBackup": false,
            "autoIncludeSafariData": false,
            "autoIncludeNotesData": false,
            "autoIncludeContacts": false,
            "shareAction": "share"
          },
          "enableLocalExport": {
            "formats": [
              "pdf"
            ],
            "defaultConfig": {
              "chunkType": "year",
              "includeAttachments": true
            }
          },
          "allowClient": {
            "allowSocialApps": [
              "whatsapp"
            ],
            "allowShareAll": false
          },
          "autoShare": {
            "allowClientApproval": false,
            "allowAdditionalShare": false,
            "searches": [
              {
                "type": "name",
                "values": [
                  "Jane Doe"
                ],
                "apps": [
                  "whatsapp"
                ],
                "dateRange": {
                  "start": "2026-05-04T09:42:00Z",
                  "end": "2026-05-04T09:42:00Z"
                },
                "exactMatch": false,
                "include": true,
                "conversationType": "all"
              }
            ]
          },
          "shareAll": {
            "apps": [
              "whatsapp"
            ],
            "includeAttachments": true,
            "dateRange": {
              "start": "2026-05-04T09:42:00Z",
              "end": "2026-05-04T09:42:00Z"
            },
            "searchesExclude": [
              {
                "type": "name",
                "values": [
                  "Jane Doe"
                ],
                "apps": [
                  "whatsapp"
                ],
                "exactMatch": false,
                "conversationType": "all"
              }
            ]
          }
        },
        "devices": [
          {}
        ],
        "totalDevicesCount": 1,
        "dueDate": "2026-01-15T14:30:00.000Z",
        "sendEmail": true,
        "lockedAt": "2026-05-04T09:42:00Z",
        "hasDueDateCrossed": false,
        "status": "pending",
        "reviewStatus": "approved",
        "reviewMessage": "string",
        "lastApprovedBy": {
          "createdAt": "2026-01-15T14:30:00.000Z",
          "updatedAt": "2026-01-15T14:30:00.000Z",
          "id": "507f1f77bcf86cd799439011",
          "name": "Jane Doe",
          "email": "jane.doe@example.com",
          "phone": [
            "+15555550100"
          ],
          "isActive": true,
          "isEmailVerified": true,
          "lastActive": "2026-01-15T14:30:00.000Z",
          "roles": [
            "user"
          ],
          "avatar": {
            "createdAt": "2026-01-15T14:30:00.000Z",
            "updatedAt": "2026-01-15T14:30:00.000Z",
            "id": "507f1f77bcf86cd799439011",
            "name": "photo.heic",
            "providerId": "uploads/507f1f77bcf86cd799439011/photo.heic",
            "convertedName": "photo.jpg",
            "convertedProviderId": "uploads/507f1f77bcf86cd799439011/photo.jpg",
            "provider": "s3",
            "size": 204800,
            "transferState": 42.0
          },
          "onboardingStatus": "completed",
          "userType": "attorney",
          "firstName": "Jane",
          "lastName": "Doe",
          "initials": "JD",
          "userOrganizations": [
            {}
          ]
        },
        "ocReviewedByOrg": {
          "createdAt": "2026-01-15T14:30:00.000Z",
          "updatedAt": "2026-01-15T14:30:00.000Z",
          "id": "507f1f77bcf86cd799439011",
          "name": "Example Law LLP",
          "slug": "example-law-llp",
          "email": "office@example.com",
          "contact": "Jane Doe",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "description": "Litigation practice",
          "phone": [
            "+15555550100"
          ],
          "logo": "https://files.example.com/logo.png",
          "isActive": true,
          "isPriority": false,
          "activePlan": {
            "createdAt": "2026-01-15T14:30:00.000Z",
            "updatedAt": "2026-01-15T14:30:00.000Z",
            "id": "507f1f77bcf86cd799439011",
            "subscription": {},
            "relatedSubscription": [
              {}
            ],
            "organization": {},
            "seats": 5,
            "seatsUsed": 3,
            "devices": 10,
            "deviceUsed": 4,
            "storage": 100000000000,
            "storageUsed": 12000000000,
            "payments": [
              {}
            ],
            "type": "admin",
            "isActive": true,
            "isBetweenPlanChanges": false,
            "storageInKb": 100000000,
            "storageUsedInKb": 12000000,
            "storageInMb": 100000,
            "storageUsedInMb": 12000,
            "storageInGb": 100,
            "storageUsedInGb": 12,
            "storageInTb": 0.1,
            "storageUsedInTb": 0.012,
            "isFreePlan": false,
            "remainingSeats": 2,
            "remainingDevices": 6,
            "remainingStorage": 88000000000
          },
          "metadata": {},
          "type": "law_firm",
          "version": "v1"
        },
        "ocReviewedAt": "2026-05-04T09:42:00Z",
        "ocRequired": true,
        "allowShareAll": false,
        "metadata": {},
        "logsConfig": {},
        "sources": [
          {
            "createdAt": "2026-01-15T14:30:00.000Z",
            "updatedAt": "2026-01-15T14:30:00.000Z",
            "id": "507f1f77bcf86cd799439011",
            "case": {},
            "extractionCode": {},
            "dataSource": {
              "createdAt": "2026-01-15T14:30:00.000Z",
              "updatedAt": "2026-01-15T14:30:00.000Z",
              "id": "507f1f77bcf86cd799439011",
              "name": "gmail",
              "displayName": "Gmail",
              "category": "email",
              "config": {
                "iosEnableEncryptedBackup": true,
                "iosAllowOnlyEncryptedBackup": false,
                "iosAllApps": [
                  "messages",
                  "call_log",
                  "whatsapp",
                  "photos"
                ],
                "iosAllowedApps": [
                  "messages",
                  "call_log"
                ]
              }
            },
            "caseDataSource": {
              "createdAt": "2026-01-15T14:30:00.000Z",
              "updatedAt": "2026-01-15T14:30:00.000Z",
              "id": "507f1f77bcf86cd799439011",
              "case": {},
              "dataSource": {
                "createdAt": "2026-01-15T14:30:00.000Z",
                "updatedAt": "2026-01-15T14:30:00.000Z",
                "id": "507f1f77bcf86cd799439011",
                "name": "gmail",
                "displayName": "Gmail",
                "category": "email",
                "config": {
                  "iosEnableEncryptedBackup": true,
                  "iosAllowOnlyEncryptedBackup": false,
                  "iosAllApps": [
                    "messages",
                    "call_log",
                    "whatsapp",
                    "photos"
                  ],
                  "iosAllowedApps": [
                    "messages",
                    "call_log"
                  ]
                }
              },
              "config": {
                "iosEnableEncryptedBackup": true,
                "iosAllowOnlyEncryptedBackup": false,
                "iosAutoIncludeSafariData": true,
                "iosAutoIncludeNotesData": false,
                "iosAllowedApps": [
                  "messages",
                  "call_log",
                  "whatsapp"
                ]
              }
            },
            "config": {
              "iosEnableEncryptedBackup": true,
              "iosAllowOnlyEncryptedBackup": false,
              "iosAllApps": [
                "messages",
                "call_log",
                "whatsapp",
                "photos"
              ],
              "iosAllowedApps": [
                "messages",
                "call_log"
              ]
            }
          }
        ],
        "payment": {}
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}