{"id":10926,"date":"2024-06-25T10:44:18","date_gmt":"2024-06-25T09:44:18","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&#038;p=10926"},"modified":"2024-06-25T12:21:33","modified_gmt":"2024-06-25T11:21:33","slug":"get-suppression-list-import-progress","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/api\/get-suppression-list-import-progress\/","title":{"rendered":"Get suppression list import progress"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\" id=\"h.aq30h4hkivo_l\"><strong>Request data format<\/strong><\/h3>\n\n\n\n<p>Request URL parameters:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Element\/attribute<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Notes<\/strong><\/td><\/tr><tr><td>apiKey<\/td><td>string<\/td><td>Your API key, required for authentication. Required.<\/td><\/tr><tr><td>ID<\/td><td>integer<\/td><td>Import ID. Required as a part of address (not GET parameter). See example below.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Example URL:\u00a0\u00a0<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#babed8;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/api.esv2.com\/v2\/Api\/ImportToSuppressionListTasks\/19?apiKey=test_api_key1\" style=\"color:#babed8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M4.5 12.75l6 6 9-13.5\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6\"><\/path><\/svg><\/span><pre class=\"shiki material-theme-palenight\" style=\"background-color: #292D3E\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #BABED8\">https:\/\/api.esv2.com\/v2\/Api\/ImportToSuppressionListTasks\/19?apiKey=test_api_key1<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h.6c42xxnr5siw_l\"><strong>Response<\/strong><\/h3>\n\n\n\n<p>Method returns an object describing the scheduled import and its execution history.<\/p>\n\n\n\n<p>Response Data element:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Element\/attribute<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Notes<\/strong><\/td><\/tr><tr><td>Name<\/td><td>string<\/td><td>Import task name.<\/td><\/tr><tr><td>List<\/td><td>string<\/td><td>Name of suppression list for imported records.<\/td><\/tr><tr><td>Url<\/td><td>string<\/td><td>URL address of file containing records to import.<\/td><\/tr><tr><td>History<\/td><td>array[complex]<\/td><td>Array of Import elements describing import executions.*<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>*History may be empty if import was never executed.<\/p>\n\n\n\n<p>Import element children:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Element\/attribute<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Notes<\/strong><\/td><\/tr><tr><td>StartedAt<\/td><td>dateTime<\/td><td>Date of import start.<\/td><\/tr><tr><td>UpdatedAt<\/td><td>dateTime<\/td><td>Date of last import status change.<\/td><\/tr><tr><td>Status<\/td><td>string<\/td><td>Import status. One of: &#8220;Queued&#8221;, &#8220;InProgress&#8221;, &#8220;Completed&#8221;, &#8220;Error&#8221;,\u00a0&#8220;Warning&#8221;.<\/td><\/tr><tr><td>Details<\/td><td>string<\/td><td>Additional information, e.g. error info if import failed.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h.mso8dzhowtrc_l\"><strong>Examples<\/strong><\/h3>\n\n\n\n<p>Request:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#babed8;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span role=\"button\" tabindex=\"0\" data-code=\"GET https:\/\/api.esv2.com\/v2\/Api\/ImportToSuppressionListTasks\/19?apiKey=test_api_key1 HTTP\/1.1 \nAccept-Encoding: gzip,deflate \nUser-Agent: Jakarta Commons-HttpClient\/3.1 \nHost: api.esv2.com\" style=\"color:#babed8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M4.5 12.75l6 6 9-13.5\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6\"><\/path><\/svg><\/span><pre class=\"shiki material-theme-palenight\" style=\"background-color: #292D3E\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #BABED8\">GET https:\/\/api.esv2.com\/v2\/Api\/ImportToSuppressionListTasks\/19?apiKey=test_api_key1 HTTP\/1.1 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Accept-Encoding: gzip,deflate <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">User-Agent: Jakarta Commons-HttpClient\/3.1 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Host: api.esv2.com<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Response:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#babed8;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span role=\"button\" tabindex=\"0\" data-code=\"HTTP\/1.1 200 OK \nCache-Control: private \nContent-Type: text\/xml; charset=utf-8 \nServer: Microsoft-IIS\/7.5 \nX-AspNetMvc-Version: 3.0 \nX-AspNet-Version: 4.0.30319 \nX-Powered-By: ASP.NET \nDate: Thu, 05 Apr 2012 15:50:13 GMT \nContent-Length: 559   \n\n &lt;ApiResponse xmlns:xsd=&quot;http:\/\/www.w3.org\/2001\/XMLSchema&quot; xmlns:xsi=&quot;http:\/\/www.w3.org\/2001\/XMLSchema-instance&quot;&gt;\n   &lt;Data&gt;\n     &lt;Name&gt;API test import&lt;\/Name&gt;\n     &lt;List&gt;API test suppression list&lt;\/List&gt;\n     &lt;Url&gt;ftp:\/\/ftp.expertsender.com\/Lists\/test.csv&lt;\/Url&gt;\n     &lt;History&gt;\n       &lt;Import&gt;\n         &lt;StartedAt&gt;2012-03-27T11:01:18&lt;\/StartedAt&gt;\n         &lt;UpdatedAt&gt;2012-03-27T11:01:27&lt;\/UpdatedAt&gt;\n         &lt;Status&gt;Completed&lt;\/Status&gt;\n         &lt;Details&gt;ftp:\/\/ftp.expertsender.com\/Lists\/test.csv&lt;\/Details&gt;\n       &lt;\/Import&gt;\n     &lt;\/History&gt;\n   &lt;\/Data&gt;\n &lt;\/ApiResponse&gt;\" style=\"color:#babed8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M4.5 12.75l6 6 9-13.5\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6\"><\/path><\/svg><\/span><pre class=\"shiki material-theme-palenight\" style=\"background-color: #292D3E\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #BABED8\">HTTP\/1.1 200 OK <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Cache-Control: private <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Content-Type: text\/xml; charset=utf-8 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Server: Microsoft-IIS\/7.5 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">X-AspNetMvc-Version: 3.0 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">X-AspNet-Version: 4.0.30319 <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">X-Powered-By: ASP.NET <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Date: Thu, 05 Apr 2012 15:50:13 GMT <\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">Content-Length: 559   <\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\"> <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">ApiResponse<\/span><span style=\"color: #89DDFF\"> <\/span><span style=\"color: #C792EA\">xmlns<\/span><span style=\"color: #89DDFF\">:<\/span><span style=\"color: #C792EA\">xsd<\/span><span style=\"color: #89DDFF\">=<\/span><span style=\"color: #89DDFF\">&quot;<\/span><span style=\"color: #C3E88D\">http:\/\/www.w3.org\/2001\/XMLSchema<\/span><span style=\"color: #89DDFF\">&quot;<\/span><span style=\"color: #89DDFF\"> <\/span><span style=\"color: #C792EA\">xmlns<\/span><span style=\"color: #89DDFF\">:<\/span><span style=\"color: #C792EA\">xsi<\/span><span style=\"color: #89DDFF\">=<\/span><span style=\"color: #89DDFF\">&quot;<\/span><span style=\"color: #C3E88D\">http:\/\/www.w3.org\/2001\/XMLSchema-instance<\/span><span style=\"color: #89DDFF\">&quot;<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">   <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Data<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">     <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Name<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">API test import<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Name<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">     <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">List<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">API test suppression list<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">List<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">     <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Url<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">ftp:\/\/ftp.expertsender.com\/Lists\/test.csv<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Url<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">     <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">History<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">       <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Import<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">         <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">StartedAt<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">2012-03-27T11:01:18<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">StartedAt<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">         <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">UpdatedAt<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">2012-03-27T11:01:27<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">UpdatedAt<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">         <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Status<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">Completed<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Status<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">         <\/span><span style=\"color: #89DDFF\">&lt;<\/span><span style=\"color: #F07178\">Details<\/span><span style=\"color: #89DDFF\">&gt;<\/span><span style=\"color: #BABED8\">ftp:\/\/ftp.expertsender.com\/Lists\/test.csv<\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Details<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">       <\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Import<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">     <\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">History<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\">   <\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">Data<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #BABED8\"> <\/span><span style=\"color: #89DDFF\">&lt;\/<\/span><span style=\"color: #F07178\">ApiResponse<\/span><span style=\"color: #89DDFF\">&gt;<\/span><\/span><\/code><\/pre><\/div>\n","protected":false},"author":13,"featured_media":0,"parent":3551,"menu_order":0,"template":"","format":"standard","emp-category":[],"class_list":["post-10926","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10926","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/13"}],"version-history":[{"count":1,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10926\/revisions"}],"predecessor-version":[{"id":10927,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/10926\/revisions\/10927"}],"up":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3551"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=10926"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=10926"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}